From e62208120c075b4762d7ca1825fd058d0f54930f Mon Sep 17 00:00:00 2001 From: Jason Washburn Date: Tue, 19 Aug 2025 10:36:42 -0500 Subject: [PATCH] chore: update README.yaml to correct example usage of atmos-version --- README.yaml | 220 ++++++++++++++++++++++++++-------------------------- 1 file changed, 110 insertions(+), 110 deletions(-) diff --git a/README.yaml b/README.yaml index 0f54333..c4c5a5f 100644 --- a/README.yaml +++ b/README.yaml @@ -1,110 +1,110 @@ -# -# This is the canonical configuration for the `README.md` -# Run `make readme` to rebuild the `README.md` -# - -# Name of this project -name: github-action-setup-atmos - -# Tags of this project -tags: - - github-action - - atmos - -# Logo for this project -#logo: docs/logo.png - -# License of this project -license: "APACHE2" - -# Canonical GitHub repo -github_repo: cloudposse/github-action-setup-atmos - -# Badges to display -badges: - - name: Latest Release - image: https://img.shields.io/github/release/cloudposse/github-action-setup-atmos.svg?style=for-the-badge - url: https://github.com/cloudposse/github-action-setup-atmos/releases/latest - - name: Last Updated - image: https://img.shields.io/github/last-commit/cloudposse/github-action-setup-atmos.svg?style=for-the-badge - url: https://github.com/cloudposse/github-action-setup-atmos/commits - - name: Slack Community - image: https://slack.cloudposse.com/for-the-badge.svg - url: https://cloudposse.com/slack - -# List any related terraform modules that this module may be used with or that this module depends on. -related: [] - -# Short description of this project -description: Install atmos for use in GitHub Actions - -introduction: |- - This repo contains a GitHub Action to setup [atmos](https://github.com/cloudposse/atmos) for use in GitHub Actions. It - installs the specified version of atmos and adds it to the `PATH` so it can be used in subsequent steps. In addition, - it optionally installs a wrapper script that will capture the `stdout`, `stderr`, and `exitcode` of the `atmos` - command and make them available to subsequent steps via outputs of the same name. -references: - - name: "github-actions-workflows" - description: "Reusable workflows for different types of projects" - url: "https://github.com/cloudposse/github-actions-workflows" - - name: "example-github-action-release-workflow" - description: "Example application with complicated release workflow" - url: "https://github.com/cloudposse/example-github-action-release-workflow" - -# How to use this project -usage: |- - ```yaml - steps: - - uses: hashicorp/setup-terraform@v2 - - - name: Setup atmos - uses: cloudposse/github-action-setup-atmos@v2 - ```` - - To install a specific version of atmos, set the `version` input: - - ```yaml - steps: - - uses: hashicorp/setup-terraform@v2 - - - name: Setup atmos - uses: cloudposse/github-action-setup-atmos@v2 - with: - version: 0.15.0 - ```` - - The wrapper script installation can be skipped by setting the `install-wrapper` input to `false`: - - ```yaml - steps: - - uses: hashicorp/setup-terraform@v2 - - - name: Setup atmos - uses: cloudposse/github-action-setup-atmos@v2 - with: - install-wrapper: false - ```` - - Subsequent steps of the GitHub action can use the wrapper scipt to capture the `stdout`, `stderr`, and `exitcode` if - the wrapper script was installed: - - ```yaml - steps: - - uses: hashicorp/setup-terraform@v2 - - - name: Setup atmos - uses: cloudposse/github-action-setup-atmos@v2 - with: - install-wrapper: true - - - name: Run atmos - id: atmos - run: atmos terraform plan - - - run: echo ${{ steps.atmos.outputs.stdout }} - - run: echo ${{ steps.atmos.outputs.stderr }} - - run: echo ${{ steps.atmos.outputs.exitcode }} - ``` - -include: [] -contributors: [] +# +# This is the canonical configuration for the `README.md` +# Run `make readme` to rebuild the `README.md` +# + +# Name of this project +name: github-action-setup-atmos + +# Tags of this project +tags: + - github-action + - atmos + +# Logo for this project +#logo: docs/logo.png + +# License of this project +license: "APACHE2" + +# Canonical GitHub repo +github_repo: cloudposse/github-action-setup-atmos + +# Badges to display +badges: + - name: Latest Release + image: https://img.shields.io/github/release/cloudposse/github-action-setup-atmos.svg?style=for-the-badge + url: https://github.com/cloudposse/github-action-setup-atmos/releases/latest + - name: Last Updated + image: https://img.shields.io/github/last-commit/cloudposse/github-action-setup-atmos.svg?style=for-the-badge + url: https://github.com/cloudposse/github-action-setup-atmos/commits + - name: Slack Community + image: https://slack.cloudposse.com/for-the-badge.svg + url: https://cloudposse.com/slack + +# List any related terraform modules that this module may be used with or that this module depends on. +related: [] + +# Short description of this project +description: Install atmos for use in GitHub Actions + +introduction: |- + This repo contains a GitHub Action to setup [atmos](https://github.com/cloudposse/atmos) for use in GitHub Actions. It + installs the specified version of atmos and adds it to the `PATH` so it can be used in subsequent steps. In addition, + it optionally installs a wrapper script that will capture the `stdout`, `stderr`, and `exitcode` of the `atmos` + command and make them available to subsequent steps via outputs of the same name. +references: + - name: "github-actions-workflows" + description: "Reusable workflows for different types of projects" + url: "https://github.com/cloudposse/github-actions-workflows" + - name: "example-github-action-release-workflow" + description: "Example application with complicated release workflow" + url: "https://github.com/cloudposse/example-github-action-release-workflow" + +# How to use this project +usage: |- + ```yaml + steps: + - uses: hashicorp/setup-terraform@v2 + + - name: Setup atmos + uses: cloudposse/github-action-setup-atmos@v2 + ```` + + To install a specific version of atmos, set the `atmos-version` input: + + ```yaml + steps: + - uses: hashicorp/setup-terraform@v2 + + - name: Setup atmos + uses: cloudposse/github-action-setup-atmos@v2 + with: + atmos-version: 0.15.0 + ```` + + The wrapper script installation can be skipped by setting the `install-wrapper` input to `false`: + + ```yaml + steps: + - uses: hashicorp/setup-terraform@v2 + + - name: Setup atmos + uses: cloudposse/github-action-setup-atmos@v2 + with: + install-wrapper: false + ```` + + Subsequent steps of the GitHub action can use the wrapper scipt to capture the `stdout`, `stderr`, and `exitcode` if + the wrapper script was installed: + + ```yaml + steps: + - uses: hashicorp/setup-terraform@v2 + + - name: Setup atmos + uses: cloudposse/github-action-setup-atmos@v2 + with: + install-wrapper: true + + - name: Run atmos + id: atmos + run: atmos terraform plan + + - run: echo ${{ steps.atmos.outputs.stdout }} + - run: echo ${{ steps.atmos.outputs.stderr }} + - run: echo ${{ steps.atmos.outputs.exitcode }} + ``` + +include: [] +contributors: []