https://github.com/gitpod-io/setup-ona
https://github.com/gitpod-io/setup-ona
Last synced: 26 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/gitpod-io/setup-ona
- Owner: gitpod-io
- Created: 2026-01-16T15:15:19.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-02T12:15:26.000Z (5 months ago)
- Last Synced: 2026-05-17T11:55:57.345Z (about 1 month ago)
- Language: JavaScript
- Size: 760 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Setup Ona CLI
A GitHub Action that downloads and configures the [Ona CLI](https://www.gitpod.io/docs/references/gitpod-cli) for use in workflows.
## Usage
```yaml
- uses: gitpod-io/setup-ona@v1
with:
token: ${{ secrets.ONA_TOKEN }} # optional
```
## Inputs
| Input | Description | Required | Default |
|-------|-------------|----------|---------|
| `channel` | Release channel: `stable` or `latest` | No | `stable` |
| `token` | Ona access token for authentication | No | - |
## Examples
### Basic usage (unauthenticated)
```yaml
steps:
- uses: gitpod-io/setup-ona@v1
- run: gitpod --help
```
### With authentication
```yaml
steps:
- uses: gitpod-io/setup-ona@v1
with:
token: ${{ secrets.ONA_TOKEN }}
- run: gitpod whoami
- run: gitpod environment list
```
### Use latest channel
```yaml
steps:
- uses: gitpod-io/setup-ona@v1
with:
channel: latest
```
### Create an environment from CI
```yaml
steps:
- uses: gitpod-io/setup-ona@v1
with:
token: ${{ secrets.ONA_TOKEN }}
- run: gitpod environment create https://github.com/${{ github.repository }}
```
## Supported platforms
- Linux (x64, arm64)
- macOS (x64, arm64)
- Windows (x64, arm64)
## Getting an Ona token
1. Go to [gitpod.io/user/tokens](https://gitpod.io/user/tokens)
2. Create a new access token
3. Add it as a repository secret named `ONA_TOKEN`
## License
MIT