Dynamic Manual Workflow

dynamic-manual-workflow.md

How to create a Dynamic Manual Workflow with Github Actions

Overview

GitHub Actions makes it easy to automate all your software workflows, now with world-class CI/CD. Build, test, and deploy your code right from GitHub. Make code reviews, branch management, and issue triaging work the way you want.

Context

With all this feature, it's still missing some feature like making a request before a the workflow is created.

For understand what is the issue, let me explain my use-case

• We deploy our build package on ECR
• We want de deploy a given package version on a given environment

So our need was to have a dropdow menu with all our build packages(dynamic) and also a dropdown menu for all our environment.

To actually fixed this, I decided to dynamically create the file on a given event, for our cas I choice on Merge on our default branch.

So this is the final flow :

• On Merge
  • Get all images from our Docker Repository
  • Format the list images and add them to the manual workflow template
  • Commit my changes and put the file to the .github/workflows directory
  • Add the token to the actions/checkout checkout to forced Github to copy on the workflow directory.

Solutions

Check out this sample file to actually understand our I deal with that

.github/workflows/deployment.template.yml: This is the file with the manual workflow created but without our list of packages version.

name: Deployment

on:
 workflow_dispatch:
   # Inputs the workflow accepts.
   inputs:
     version:
       description: 'Package version to deployed'
       required: true
       type: choice
       options:
         $IMAGES_OPTIONS
     environment:
       description: 'Target Environment'
       required: true
       type: choice
       options:
         - DEV
         - PROD
jobs:
 deployment:
   runs-on: ubuntu-latest
   name: "Deploying on : ${{ inputs.environment }} 🌍"
   ... your normal workflow

The file is below is the template for the final Manual Workflow and the $IMAGES_OPTIONS variables will be replace on the merge event.

name: Generate ECR Image

on:
  pull_request_target:
    types:
      - closed
    branches:
      - develop
jobs:
  get-images-list:
    runs-on: ubuntu-latest
    environment: ${{ inputs.environment }}
    steps:
      - name: checkout code
        uses: actions/checkout@v3
        with:
          token: ${{ secrets.accessToken }}

      - name: Configure AWS Credentials
        uses: aws-actions/configure-aws-credentials@v1
        with:
          aws-access-key-id: ${{ secrets.awsAccessKeyId }}
          aws-secret-access-key: ${{ secrets.awsSecretKey }}
          aws-region: ${{ secrets.awsRegionName }}

      - name: Get All Images On ECR
        run: |
          responses=$(aws ecr list-images --repository-name ${{ secrets.awsEcrRepository }} | (jq '.imageIds'))
          output=""
          for release in $(echo $responses | jq '.[] | .imageTag')
          do
             output+="- $release\n          "
          done
          sed "s/\$IMAGES_OPTIONS/$output/g" $GITHUB_WORKSPACE/.github/workflows/deployment.template.yml > $GITHUB_WORKSPACE/.github/workflows/deployment.yml

      - uses: stefanzweifel/git-auto-commit-action@v4
        with:
          commit_message: Generated images
    

And this last step file just get the images from ECR and format it to the new deployment file deployment.yml and with stefanzweifel/git-auto-commit-action we commit the changed and Github can handled it if it's on the default branch.

I hope this Gist help you. Do not hesitate to let comment or any questions you have.