https://github.com/upbound/action-up
GitHub Actions for Upbound - up
https://github.com/upbound/action-up
action actions github-action github-actions
Last synced: 4 months ago
JSON representation
GitHub Actions for Upbound - up
- Host: GitHub
- URL: https://github.com/upbound/action-up
- Owner: upbound
- License: mit
- Created: 2024-12-04T22:42:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-20T21:15:56.000Z (10 months ago)
- Last Synced: 2025-08-20T23:27:21.076Z (10 months ago)
- Topics: action, actions, github-action, github-actions
- Language: TypeScript
- Homepage:
- Size: 206 KB
- Stars: 2
- Watchers: 16
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GitHub Actions for Upbound - up
This action enabbles you to interact with Upbound by installing the up CLI.
## Usage
To install the latest version of `up` and use it in GitHub Actions workflows,
[create an Upbound API token](https://docs.upbound.io/all-spaces/spaces/console/#create-a-personal-access-token),
[add it as a secret to your repository](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions#creating-encrypted-secrets-for-a-repository),
and add the following step to your workflow:
```yaml
- name: Install and login with up
uses: upbound/action-up@v1
with:
api-token: ${{ secrets.UP_API_TOKEN }}
organization: my-org
```
`up` will now be available in the environement and can be used in following
steps. As an example, you can set your Upbound context:
```yaml
- name: Install and login with up
uses: upbound/action-up@v1
with:
api-token: ${{ secrets.UP_API_TOKEN }}
organization: my-org
- name: Set Upbound context
run: up ctx my-org/upbound-gcp-us-west-1/default/my-ctp
```
To install up without authentication:
```yaml
- name: Install up
uses: upbound/action-up@v1
with:
skip-login: true
```
## Contributing
> [!NOTE]
>
> You'll need to have a reasonably modern version of
> [Node.js](https://nodejs.org) handy. If you are using a version manager like
> [`nodenv`](https://github.com/nodenv/nodenv) or
> [`nvm`](https://github.com/nvm-sh/nvm), you can run `nodenv install` in the
> root of your repository to install the version specified in
> [`package.json`](./package.json). Otherwise, 20.x or later should work!
1. :hammer_and_wrench: Install the dependencies
```bash
npm install
```
1. :building_construction: Package the JavaScript for distribution
```bash
npm run bundle
```
1. :white_check_mark: Run the tests
```bash
$ npm test
PASS __tests__/main.test.js
action
✓ installs the up cli successfully (2 ms)
✓ installs the up cli successfully without a v in front of the version (1 ms)
PASS __tests__/index.test.js
index
✓ calls run when imported (1 ms)
...
```