← 返回命令列表

Linux command

concourse 命令

文件

复制后可按需替换文件名、目录或参数。

常用示例

Start a quickstart all-in-one

concourse quickstart --add-local-user [admin]:[password] --main-team-local-user [admin]

Start the web node

concourse web --postgres-host [localhost] --postgres-user [concourse] --postgres-password [password]

Start a worker node

concourse worker --work-dir [/var/lib/concourse/worker] --tsa-host [127.0.0.1:2222]

Generate RSA session signing key

concourse generate-key -t rsa -f [/path/to/session_signing_key]

Generate SSH key

concourse generate-key -t ssh -f [/path/to/tsa_host_key]

Run database migrations

concourse migrate --postgres-host [localhost] --postgres-user [concourse]

Retire a worker

concourse retire-worker --name [worker-name]

Display help

concourse [web|worker|quickstart] --help

说明

Concourse is a container-based continuous integration system. The concourse CLI is used to run and manage Concourse server components including the web node (ATC for scheduling, TSA for worker registration) and worker nodes (for running pipeline tasks). All configuration is defined via flags or environment variables. Each flag has a corresponding env var with the format CONCOURSE_FLAG_NAME (uppercase, underscores instead of dashes). For typical usage, the quickstart command provides an all-in-one setup suitable for development. Production deployments typically run separate web and worker processes, often on different machines. Users interact with Concourse through the fly CLI, not the concourse command directly.

参数

--add-local-user _USER_:_PASSWORD_
Add a local user for authentication.
--main-team-local-user _USER_
Grant main team access to a local user.
--postgres-host _HOST_
PostgreSQL server hostname.
--postgres-user _USER_
PostgreSQL username.
--postgres-password _PASSWORD_
PostgreSQL password.
--external-url _URL_
Externally reachable URL of the Concourse web UI.
--work-dir _PATH_
Directory for worker to store container data.
--tsa-host _HOST_:_PORT_
TSA host for worker registration (default: 127.0.0.1:2222).
--session-signing-key _PATH_
RSA key for signing and verifying user session tokens (web node).
--tsa-host-key _PATH_
SSH private key for the TSA worker registration gateway (web node).
--tsa-authorized-keys _PATH_
File containing authorized worker public keys (web node).
--tsa-public-key _PATH_
TSA host public key for verification (worker node).
--tsa-worker-private-key _PATH_
Worker private key for authenticating to TSA (worker node).
--runtime _RUNTIME_
Container runtime to use (guardian or containerd).
--help
Display help for the command.

FAQ

What is the concourse command used for?

Concourse is a container-based continuous integration system. The concourse CLI is used to run and manage Concourse server components including the web node (ATC for scheduling, TSA for worker registration) and worker nodes (for running pipeline tasks). All configuration is defined via flags or environment variables. Each flag has a corresponding env var with the format CONCOURSE_FLAG_NAME (uppercase, underscores instead of dashes). For typical usage, the quickstart command provides an all-in-one setup suitable for development. Production deployments typically run separate web and worker processes, often on different machines. Users interact with Concourse through the fly CLI, not the concourse command directly.

How do I run a basic concourse example?

Run `concourse quickstart --add-local-user [admin]:[password] --main-team-local-user [admin]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --add-local-user _USER_:_PASSWORD_ do in concourse?

Add a local user for authentication.