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

GitHub Action

install-aws-cli-action

v1.0.3

install-aws-cli-action

download-cloud

install-aws-cli-action

Install AWS CLI on a Linux host

Installation

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

              

- name: install-aws-cli-action

uses: unfor19/[email protected]

Learn more about this action in unfor19/install-aws-cli-action

Choose a version

install-aws-cli-action

test test-action

Install AWS CLI on a GitHub Actions Linux host.

After this action, every step is capable of running aws CLI, and it's up to you to set the environment variables (secrets) AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.

Tested in unfor19/install-aws-cli-action-test

Usage

Valid version values:

  • 1 - latest v1
  • 2 - latest v2 (default)
  • 1.##.## - specific v1
  • 2.##.## - specific v2

Usage

Add the following step to a job in your workflow

- id: install-aws-cli
  uses: unfor19/[email protected]
  with:
    version: 2     # default
    verbose: false # default
    arch: amd64    # allowed values: amd64, arm64
    rootdir: ""    # defaults to "PWD"
    workdir: ""    # defaults to "PWD/unfor19-awscli"

Full example

See unfor19/install-aws-cli-action-test/blob/master/.github/workflows/test-action.yml

name: test-action

on:
  push:

jobs:
  test:
    runs-on: ubuntu-20.04
    strategy:
      matrix:
        include:
          - TEST_NAME: "Latest v2"
            AWS_CLI_VERSION: "2"
          - TEST_NAME: "Specific v2"
            AWS_CLI_VERSION: "2.0.30"
          - TEST_NAME: "Latest v1"
            AWS_CLI_VERSION: "1"
          - TEST_NAME: "Specific v1"
            AWS_CLI_VERSION: "1.18.1"
          - TEST_NAME: "No Input"
    name: Test ${{ matrix.TEST_NAME }} ${{ matrix.AWS_CLI_VERSION }}
    steps:
      - name: Test ${{ matrix.TEST_NAME }}
        id: install-aws-cli
        uses: unfor19/install-aws-cli-action@master
        with:
          version: ${{ matrix.AWS_CLI_VERSION }}
      - run: aws --version
        shell: bash

Other options

  • Execute locally
    curl -L -o install-aws.sh https://raw.githubusercontent.com/unfor19/install-aws-cli-action/master/entrypoint.sh && \
    chmod +x install-aws.sh
    ./install-aws.sh "v2" "amd64"
    rm install-aws.sh  
  • Dockerfile - Add this to your Dockerfile
    # Install AWS CLI
    WORKDIR /tmp/
    RUN curl -L -o install-aws.sh https://raw.githubusercontent.com/unfor19/install-aws-cli-action/master/entrypoint.sh && \
        sudo chmod +x install-aws.sh && \
        sudo ./install-aws.sh "v2" "amd64" && \
        sudo rm install-aws.sh
    NOTE: On some Docker images you might need to add sudo in front of each command, like sudo curl -L .., sudo chmod .., etc.

Local Development

Expand/Collapse

Requirements

  • Docker

Getting Started

  1. Build Docker image
    docker build -t "install-aws-cli-action" .
  2. Run container
    docker run --rm -it "install-aws-cli-action" "v2" "amd64"

Authors

Created and maintained by Meir Gabay

License

This project is licensed under the MIT License - see the LICENSE file for details