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.