Pipeline

List of all available properties for a Copilot pipeline manifest.

Sample manifest for a pipeline triggered from a GitHub repo

name: pipeline-sample-app-frontend
version: 1

source:
  provider: GitHub
  properties:
    branch: main
    repository: https://github.com/<user>/sample-app-frontend
    # Optional: specify the name of an existing CodeStar Connections connection.
    connection_name: a-connection

stages:
    - 
      name: test
      test_commands:
        - make test
        - echo "woo! Tests passed"
    - 
      name: prod
      requires_approval: true

name String
The name of your pipeline.

version String
The schema version for the template. There is only one version, 1, supported at the moment.

source Map Configuration for how your pipeline is triggered.

source.provider String
The name of your provider. Currently, GitHub, Bitbucket, and CodeCommit are supported.

source.properties Map
Provider-specific configuration on how the pipeline is triggered.

Info

As of AWS Copilot v1.4.0, the access token is no longer needed for GitHub repository sources. Instead, Copilot will trigger the pipeline using AWS CodeStar connections.

source.properties.branch String
The name of the branch in your repository that triggers the pipeline. The default for GitHub is main; the default for Bitbucket and CodeCommit is master.

source.properties.repository String
The URL of your repository.

source.properties.connection_name String
The name of an existing CodeStar Connections connection. If omitted, Copilot will generate a connection for you.

stages Array of Maps
Ordered list of environments that your pipeline will deploy to.

stages.name String
The name of an environment to deploy your services to.

stages.requires_approval Boolean
Indicates whether to add a manual approval step before the deployment.

stages.test_commands Array of Strings
Commands to run integration or end-to-end tests after deployment.