install-aws-cli-action
Install/Setup 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 AWS credentials in the subsequent steps.
Forked from unfor19/install-aws-cli-action
TIP: It's possible to use the entrypoint.sh script as a "bootstrap script to install/setup aws cli on Linux", regardless of GitHub Actions; see Other Options for more details.
Usage
Valid AWS CLI version
values:
1
- latest v12
- latest v2 (default)1.##.##
- specific v12.##.##
- specific v2
Usage
Add the following step to a job in your workflow
- id: install-aws-cli
uses: bishopfox/install-aws-cli-action@v1
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: bishopfox/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
NOTE: On some Docker images, you might need to add
# 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
sudo
in front of each command, likesudo curl -L ..
,sudo chmod ..
, etc.
Local Development
Expand/Collapse
Requirements
- Docker
Getting Started
- Build Docker image
docker build -t "install-aws-cli-action" .
- Run container
docker run --rm -it "install-aws-cli-action" "v2" "amd64"
Authors
Created and original maintained by Meir Gabay Forked and currently maintained by Bishop Fox Consulting Engineering
License
This project is licensed under the MIT License - see the LICENSE file for details