burtonr / octopus-cli-action

GitHub Action for using the OctopusDeploy CLI

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

OctopusDeploy CLI Action

This is NOT an official OctopusDeploy Project. Please see: Install Octopus-CLI for the official Action

Inputs

With the exception of the command input, all inputs may be provided with the OctopusCLI Environment variables rather than arguments. This will allow you to set the value once per workflow or job and not need to pass them in again simplifying the workflow yaml file.

server

Optional The full URL of your OctopusDeploy server

Example: https://your.octopus.com

  • As an environment variable: OCTOPUS_CLI_SERVER

apiKey

Optional The API key generated by your OctopusDeploy server

  • As an environment variable: OCTOPUS_CLI_API_KEY

More information here: How to Create an API Key

username

Optional Used when passing credentials and not an API key

  • As an environment variable: OCTOPUS_CLI_USERNAME

password

Optional Used when passing credentials and not an API key

  • As an environment variable: OCTOPUS_CLI_PASSWORD

command

Optional The command and parameters to use with the CLI

Default value: version

Example: `deploy-release --project=CoolestProject --deployTo=PROD --version=1.2.3

More information about the commands and available options can be found in the official documentation

Example Usage

With Arguments

uses: burtonr/octopus-cli-action@7.4.4
with:
  server: https://octopus.forme.io
  apiKey: ${{ secrets.OCTOPUS_API_KEY }}
  command: deploy-release --project=CoolestProject --deployTo=PROD --version=1.2.3

With Environment

jobs:
  job1:
    env:
      OCTOPUS_CLI_SERVER: https://octopus.yoursite.com
      OCTOPUS_CLI_API_KEY: ${{ secrets.OCTOPUS_API_KEY }}
    steps:
      - name: step1
        uses: burtonr/octopus-cli-action@7.4.4
        with:
          command: deploy-release --project=CoolestProject --deployTo=PROD --version=1.2.3

About

GitHub Action for using the OctopusDeploy CLI