Skip to content
code

GitHub Action

LocalStack GitHub Actions Login

v0.1.0 Latest version

LocalStack GitHub Actions Login

code

LocalStack GitHub Actions Login

Logs in to your LocalStack account in GitHub Actions

Installation

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

              

- name: LocalStack GitHub Actions Login

uses: localstack/[email protected]

Learn more about this action in localstack/localstack-github-actions-login

Choose a version

LocalStack GitHub Actions Login

Test LocalStack GitHub Actions Login tag badge license badge size badge

A GitHub Action to log-in into your LocalStack account on your GitHub Actions runner workflow by specifying your Email Address and Password. See the LocalStack Documentation for an explanation of a log in using localstack CLI, which this action wraps.

Usage

To get started, you can use this minimal example:

- name: 🤔 Login to LocalStack
  uses: LocalStack/[email protected]
  with:
    email: ${{ secrets.LOCALSTACK_USERNAME }}
    password: ${{ secrets.LOCALSTACK_PASSWORD }}

Inputs

Input Description Default
email Email address with which you have configured your LocalStack account None
password Password with which you authenticate your LocalStack account None

Example Workflow

This example workflow will pull the latest version of LocalStack Pro image with an API key configured in the LOCALSTACK_API_KEY secret. It will then pull a log-in using the LOCALSTACK_USERNAME and LOCALSTACK_PASSWORD secrets. Finally, it will pull a Cloud Pod available in your LocalStack account.

name: 'Test your AWS infrastructure with LocalStack'

on: [ push, pull_request ]

jobs:
  test:
    name: 🌐 Pull a Cloud Pod
    runs-on: ubuntu-latest
    steps:
      - name: ⚡️ Checkout the repository
        uses: actions/checkout@v3

      - name: ☁️ Start LocalStack
        run: |
          pip install pyopenssl -U
          docker pull localstack/localstack-pro:1.4
          pip install localstack
          DNS_ADDRESS=0 localstack start -d
          localstack wait -t 30
          pip install awscli-local[ver1]
        env:
          LOCALSTACK_API_KEY: ${{ secrets.LOCALSTACK_API_KEY }}

      - name: 🤔 Login to LocalStack
        uses: LocalStack/[email protected]
        with:
          email: ${{ secrets.LOCALSTACK_USERNAME }}
          password: ${{ secrets.LOCALSTACK_PASSWORD }}

      - name: 🤩 Pull a Cloud Pod
        run: |
          localstack pod load <pod-name> # Add the name of the Cloud Pod you want to pull
          localstack pod list

     - name: Run our tests
       run: |
         awslocal ... # Do your testing here

License

Apache License 2.0