Code Pipeline Deploy

The Code Pipeline Deploy action allows your GitHub Actions workflow to trigger a deploy in your instance of BMC AMI DevX Workbench Code Pipeline on the mainframe. This action can be used in scenarios where your mainframe source is stored in Git, or when you want your GitHub Actions workflow to operate on source that is already stored in Code Pipeline.

Templates

Create a GitHub workflow file, for example, ispw-sync-build-deploy.yml the workflow is broken up into the following stages:

• Checkout - checks out the source code.
• Synchronize changeset to Code Pipeline - uses GitHub action Code Pipeline Sync to perform GitHub to Code Pipeline synchronization.
• Build Code Pipeline tasks - uses GitHub action Code Pipeline Build to perform a build
• Deploy Code Pipeline tasks - uses gitHub action Code Pipeline Deploy to perform a deploy

Or if you prefer to use GitHub action Code Pipeline Sync Local, you may specify the sync step. For example, ispw-sync-local-generate-deploy.yml the workflow is broken up into the following stages :

• Checkout - checks out the source code.
• Synchronize changeset to Code Pipeline - uses GitHub action Code Pipeline Sync Local to perform GitHub to Code Pipeline synchronization.
• Generate Code Pipeline tasks - uses GitHub action Code Pipeline Generate to perform a generate
• Deploy Code Pipeline tasks - uses gitHub action Code Pipeline Deploy to perform a deploy

Example usage

The following example will automatically retrieve the deploy parameters from a previous step in the job

on: [push]

jobs:
  run-ispw-generate-deploy:
    runs-on: ubuntu-latest
    name: A job to sync git source into Code Pipeline, then deploy it on the mainframe
    steps:
      - name: Sync step
        uses: bmc-compuware/ispw-sync@v20.6.1.gtk
        id: sync
        with:
          host: 'host.example.com'
          port: 37733
          uid: ${{ secrets.TSOUSER }}
          pass: ${{ secrets.TSOPASS }}
          runtimeConfiguration: 'ISPW'
          stream: 'PLAY'
          application: 'PLAY'
          checkoutLevel: 'DEV2'
          gitUid: 'admin'
          gitToken: ${{ secrets.GITHUB_TOKEN }}
          showEnv: true
      - name: Generate
        uses: bmc-compuware/ispw-generate@v1
        id: generate
        with:
          ces_url: 'https://CES:48226/'
          ces_token: ${{ secrets.CES_TOKEN }}
          srid: 'host-37733'
          runtime_configuration: 'ISPW'
          generate_automatically: ${{ steps.sync.outputs.automaticBuildJson }}
      - name: Get the number of generate failures
        run: echo "The number of generate failures is ${{ steps.generate.outputs.generate_failed_count }}"
      - name: Deploy
        uses: bmc-compuware/ispw-deploy@v1
        id: deploy
        with:
          ces_url: 'https://CES:48226/'
          ces_token: ${{ secrets.CES_TOKEN }}
          srid: 'host-37733'
          runtime_configuration: 'ISPW'
          deploy_automatically: ${{ steps.sync.outputs.automaticBuildJson }}

The following example will deploy two specific Code Pipeline tasks within assignment PLAY000826 using ces_token as authentication method.

on: [push]

jobs:
  run-ispw-deploy:
    runs-on: ubuntu-latest
    name: A job to deploy in Code Pipeline
    steps:
      - name: Deploy
        uses: bmc-compuware/ispw-deploy@v1
        id: deploy
        with:
          ces_url: "https://CES:48226/"
          ces_token: ${{ secrets.CES_TOKEN }}
          srid: host-37733
          runtime_configuration: ISPW
          assignment_id: PLAY000826
          level: DEV1
          task_id: "7E3A5B274D24,7E3A5B274EFA"
      - name: Get the set ID for the deploy
        run: echo "The Code Pipeline set used for the deploy is ${{ steps.deploy.outputs.set_id }}"

The following example will deploy two specific Code Pipeline tasks within assignment PLAY000826 using certificate as authentication method.

on: [push]

jobs:
  run-ispw-deploy:
    runs-on: ubuntu-latest
    name: A job to deploy in Code Pipeline
    steps:
      - name: Deploy
        uses: bmc-compuware/ispw-deploy@v1
        id: deploy
        with:
          ces_url: "https://CES:48226/"
          certificate: ${{ secrets.certificate }}
          srid: host-37733
          runtime_configuration: ISPW
          assignment_id: PLAY000826
          level: DEV1
          task_id: "7E3A5B274D24,7E3A5B274EFA"
      - name: Get the set ID for the deploy
        run: echo "The Code Pipeline set used for the deploy is ${{ steps.deploy.outputs.set_id }}"

Inputs

Input name	Required	Description
ces_url	Required	The URL to use when connecting to CES
srid	Required	The SRID of the Code Pipeline instance to connect to
change_type	Optional	The change type of this request. The default value is 'S' for standard.
execution_status	Optional	The flag to indicate whether the deploy should happen immediately, or should be held. The default is 'I' for immediate. Other possible value is 'H' for hold.
runtime_configuration	Optional	The runtime configuration for the instance of Code Pipeline you are connecting to.
deploy_automatically	Optional	A string of JSON that contains the parameters for the deploy. If using a Code Pipeline Sync step before the deploy, this JSON string can be retrieved from the outputs of that step. If deploy_automatically is not being used, then the assignment_id, level, and task_id must be specified.
assignment_id	Optional	The assignment for which you intend to deploy tasks. Do not use if deploy_automatically has already been specified.
level	Optional	The level that the tasks exist at in the assignment. Do not use if deploy_automatically has already been specified.
task_id	Optional	The comma-separated string of task IDs for the tasks that need to be deployd. Do not use if deploy_automatically has already been specified.

| ces_token | Optional | The token to use when authenticating the request to CES | | certificate | Optional | The certificate to use when authenticating the request to CES |

NOTE

Users must pass one of the authentication method in workflow i.e ces_token or certificate

Outputs

Output name	Output type	Description
set_id	string	The ID of the set that was used for processing.
url	string	The URL that can be used to retrieved information about the set that was used for processing.

Setup

Create a token in Common Enterprise Services (CES)

In order to use this action, you must access an instance of the CES product. You will need to open CES in your web browser and create a token to be used during CES requests. To set up a new host connection, go to the hamburger menu in the upper left corner and select Host Connections.

On the Host Connection Settings page, click "Add." Set up the host connection to be used for Code Pipeline and click OK when finished.

Then, go back to the menu and select Security. On the Security page, click Add and the Personal Access Token dialog will come up.

On the Personal Access Token dialog, select the host that you want to create a token for, and enter in the mainframe username and password.

Once done, there will be a new token in the table on the Security page

Save the token as a GitHub Secret

From the Security page in CES, copy the token. In GitHub go to Settings > Secrets and click the button for New Repository Secret.

On the New Secret page, paste the token that was copied earlier and click the Add secret button. Make a note of the name you give the secret so that you can easily use it in your workflow script.

Save the certificate as a GitHub Secret

Once you get the certificate, copy the 64bit text without and line breaks. In GitHub go to Settings > Secrets and click the button for New Repository Secret.

On the New Secret page, paste the certificate that was copied earlier and click the Add secret button. Make a note of the name you give the secret so that you can easily use it in your workflow script.

Fill in the workflow script

Use the examples above to fill in a workflow script using the Code Pipeline Deploy action. Note that if you want the input assignment, level, and taskIds to be automatically picked up from the Code Pipeline synchronization with Git, you will need synchronization step in your job, which will run before the deploy.

Troubleshooting

To enable debug logging in your GitHub actions workflow, see the guide here.

See also

• License