README.md

install-aws-cli-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

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