GitHub Action
AWS CodePipeline Trigger
This GitHub Actions will help you trigger a pipeline in your AWS CodePipeline - assumming you already have the pipeline. This will not create the pipeline for you.
Create an IAM user with codepipeline:StartPipelineExecution
permission. You may take and customize the IAM policy below as starter point. Note that I'm using "*"
in the policy. For better security, you can limit the policy to only execute specific pipelines. You can read more about IAM for CodePipeline here.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codepipeline:StartPipelineExecution"
],
"Resource": [
"*"
]
}
]
}
After you create the IAM user with the right permission, add two variables below in your GitHub repository secrets area:
AWS_PIPELINE_ACCESS_KEY
: the Access Key ID for the user that you just createdAWS_PIPELINE_SECRET_KEY
: the Secret Key for the user that you just created
Note:
-
Please check the latest available version here and replace it with
X.X.X
in the code examples below. -
Identify in which AWS region your pipeline is located. Use that region name for
aws-region
key below. AWS regions list is available here.
jobs:
deploy:
steps:
- name: Trigger AWS CodePipeline
uses: zulhfreelancer/[email protected]
with:
aws-region: "ap-southeast-1"
aws-access-key: ${{ secrets.AWS_PIPELINE_ACCESS_KEY }}
aws-secret-key: ${{ secrets.AWS_PIPELINE_SECRET_KEY }}
pipeline-name: "your-pipeline-name"
Below is the example for situation where:
- You only want to trigger the pipeline if previous job was successful
- You only want to trigger the pipeline if the Git branch that GitHub Actions currently running is a specific branch
jobs:
job1:
... code for job1 ...
deploy:
needs: job1
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Trigger AWS CodePipeline
uses: zulhfreelancer/[email protected]
if: github.ref == 'refs/heads/your-branch-name'
with:
aws-region: "ap-southeast-1"
aws-access-key: ${{ secrets.AWS_PIPELINE_ACCESS_KEY }}
aws-secret-key: ${{ secrets.AWS_PIPELINE_SECRET_KEY }}
pipeline-name: "your-pipeline-name"
Feel free to fork and submit PRs for this project. I'm more than happy to review and merge it. If you have any questions regarding contributing, feel free to reach out to me on Twitter.