Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
octopusdeploy

GitHub Action

Install Octopus CLI

v1.1.6

Install Octopus CLI

octopusdeploy

Install Octopus CLI

GitHub Action to install the Octopus CLI

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Install Octopus CLI

uses: OctopusDeploy/install-octopus-cli-action@v1.1.6

Learn more about this action in OctopusDeploy/install-octopus-cli-action

Choose a version

install-octopus-cli-action

This is a GitHub Action to install the Octopus CLI on runners and self-hosted environments. Once installed, the Octopus CLI may be used to issue commands to Octopus Deploy. Subsequent actions may use the Octopus CLI, which is cached and available via PATH.

What is the Octopus CLI?

The Octopus CLI is a command line tool that builds on top of the Octopus REST API. It enables you to package applications for deployment and manage your environments, deployments, channels, projects, and workers in Octopus Deploy.

Examples

To install the latest version of the Octopus CLI:

steps:
  - uses: actions/checkout@v2
  - name: Install Octopus CLI ๐Ÿ™
    uses: OctopusDeploy/install-octopus-cli-action@v1.1.5
    with:
      version: latest

To install a specific version of the Octopus CLI:

steps:
  - uses: actions/checkout@v2
  - name: Install Octopus CLI ๐Ÿ™
    uses: OctopusDeploy/install-octopus-cli-action@v1.1.5
    with:
      version: 7.4.3140

Here's an example of invoking the list-deployments command after installing the Octopus CLI:

steps:
  - uses: actions/checkout@v2
  - name: Install Octopus CLI ๐Ÿ™
    uses: OctopusDeploy/install-octopus-cli-action@v1.1.5
    with:
      version: 7.4.2
  - name: list-octopusdeploy-deployments
    run: >
      octo list-deployments --server=${{ env.serverURL }}
        --apiKey=${{ secrets.apiKey }}

Action Inputs

The following inputs are optional:

Name Description Default
version The version number of the Octopus CLI to download and install (i.e. 7.4.3140). latest