{"id":27946666,"url":"https://github.com/upcloudltd/upcloud-cli-action","last_synced_at":"2025-08-23T19:47:19.673Z","repository":{"id":287405725,"uuid":"896046712","full_name":"UpCloudLtd/upcloud-cli-action","owner":"UpCloudLtd","description":"GitHub Action for UpCloud CLI","archived":false,"fork":false,"pushed_at":"2025-07-02T08:18:23.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-02T09:30:35.396Z","etag":null,"topics":["cli","github-actions","upcloud"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UpCloudLtd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-29T12:42:44.000Z","updated_at":"2025-07-02T08:18:25.000Z","dependencies_parsed_at":"2025-05-07T13:57:02.929Z","dependency_job_id":"37e27165-e2c3-480a-b4eb-d0940d13fde6","html_url":"https://github.com/UpCloudLtd/upcloud-cli-action","commit_stats":null,"previous_names":["upcloudltd/upcloud-cli-action"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/UpCloudLtd/upcloud-cli-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpCloudLtd%2Fupcloud-cli-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpCloudLtd%2Fupcloud-cli-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpCloudLtd%2Fupcloud-cli-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpCloudLtd%2Fupcloud-cli-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UpCloudLtd","download_url":"https://codeload.github.com/UpCloudLtd/upcloud-cli-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UpCloudLtd%2Fupcloud-cli-action/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265344831,"owners_count":23750566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","github-actions","upcloud"],"created_at":"2025-05-07T13:56:58.543Z","updated_at":"2025-07-14T20:32:56.367Z","avatar_url":"https://github.com/UpCloudLtd.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UpCloud CLI for GitHub Actions\n\nA GitHub Action that installs and configures the [UpCloud CLI](https://github.com/UpCloudLtd/upcloud-cli) (`upctl`) for managing UpCloud infrastructure in your GitHub Actions workflows.\n\n## Features\n\n- Automatically installs the UpCloud CLI tool\n- Configures authentication with your UpCloud API credentials\n- Supports specific version installation or latest version\n- Works across different operating systems (Linux, macOS, Windows)\n\n## Usage\n\n### Basic Example\n\n```yaml\nname: Deploy to UpCloud\n\non:\n  push:\n    branches: [main]\n\njobs:\n  deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout code\n        uses: actions/checkout@v4\n\n      - name: Setup UpCloud CLI\n        uses: upcloudltd/upcloud-cli-action@main\n        with:\n          token: ${{ secrets.UPCLOUD_TOKEN }}\n        env:\n          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n      - name: List UpCloud servers\n        run: upctl server list\n```\n\n### Inputs\n\n| Input      | Description                    | Required | Default  |\n| ---------- | ------------------------------ | -------- | -------- |\n| `username` | UpCloud API Username           | No       | -        |\n| `password` | UpCloud API Password           | No       | -        |\n| `token`    | UpCloud API Token              | No       | -        |\n| `version`  | UpCloud CLI version to install | No       | `latest` |\n\nDefine either `token` or `username` and `password` to configure authentication.\n\n### Environment\n\nIf the `GH_TOKEN` environment variable is set to a non-empty value,\ndownloads are verified against\n[their artifact attestations](https://github.com/UpCloudLtd/upcloud-cli/attestations)\nusing the [`gh`](https://cli.github.com) tool.\n\n## Authentication\n\nStore your UpCloud API credentials as GitHub secrets:\n\n1. Go to your GitHub repository → Settings → Secrets and variables → Actions\n2. Create secrets for `UPCLOUD_USERNAME` and `UPCLOUD_PASSWORD`\n3. Use these secrets in your workflow as shown in the example above\n\n## Examples\n\n### Deploy to Kubernetes with Helm\n\n```yaml\nsteps:\n  - name: Setup UpCloud CLI\n    uses: upcloudltd/upcloud-cli-action@main\n    with:\n      username: ${{ secrets.UPCLOUD_USERNAME }}\n      password: ${{ secrets.UPCLOUD_PASSWORD }}\n\n  - name: Setup Helm\n    uses: azure/setup-helm@v3\n\n  - name: Generate kubeconfig\n    run: |\n      upctl kubernetes config my-cluster --write kubeconfig.yaml\n      echo \"KUBECONFIG=kubeconfig.yaml\" \u003e\u003e $GITHUB_ENV\n\n  - name: Deploy with Helm\n    run: |\n      helm repo add bitnami https://charts.bitnami.com/bitnami\n      helm upgrade --install my-app bitnami/nginx --namespace my-namespace --create-namespace\n```\n\n### Use a Specific upctl Version\n\n```yaml\nsteps:\n  - name: Setup UpCloud CLI\n    uses: upcloudltd/upcloud-cli-action@main\n    with:\n      username: ${{ secrets.UPCLOUD_USERNAME }}\n      password: ${{ secrets.UPCLOUD_PASSWORD }}\n      version: \"3.19.0\" # Specify a version\n```\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupcloudltd%2Fupcloud-cli-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fupcloudltd%2Fupcloud-cli-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupcloudltd%2Fupcloud-cli-action/lists"}