https://github.com/vbem/setup-hcloud

🌼 Setup Huawei Cloud KooCLI - `hcloud` CLI
https://github.com/vbem/setup-hcloud

cli hcloud huawei huaweicloud hw koocli

Last synced: 10 days ago
JSON representation

🌼 Setup Huawei Cloud KooCLI - `hcloud` CLI

• Host: GitHub
• URL: https://github.com/vbem/setup-hcloud
• Owner: vbem
• License: apache-2.0
• Created: 2026-04-13T13:20:54.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-05-05T06:38:23.000Z (about 2 months ago)
• Last Synced: 2026-05-05T08:28:07.682Z (about 2 months ago)
• Topics: cli, hcloud, huawei, huaweicloud, hw, koocli
• Homepage: https://github.com/marketplace/actions/setup-hcloud
• Size: 18.6 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# 🌼 GitHub Action to Setup Huawei Cloud KooCLI - `hcloud` CLI

[![🧪 Testing](https://github.com/vbem/setup-hcloud/actions/workflows/test.yml/badge.svg)](https://github.com/vbem/setup-hcloud/actions/workflows/test.yml)

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/vbem/setup-hcloud?label=Release&logo=github)](https://github.com/vbem/setup-hcloud/releases)

[![Marketplace](https://img.shields.io/badge/GitHub%20Actions-Marketplace-blue?logo=github)](https://github.com/marketplace/actions/setup-hcloud)

## About

[***KooCLI***](https://support.huaweicloud.com/hcli/index.html) is the official command-line tool for Huawei Cloud. Huawei Cloud previously provided a [simple installation action](https://github.com/huaweicloud/huaweicloud-cli-action), but that repository currently returns 404. This action provides an alternative way to install KooCLI in your workflows. It supports Linux, macOS, and Windows runners, and can download KooCLI binaries from an internal mirror when needed.

## Example usage

```yaml

- name: Setup HW Cloud KooCLI

  uses: vbem/setup-hcloud@main

- name: Test KooCLI with Huawei Cloud STS

  env:

    HUAWEICLOUD_SDK_REGION: cn-north-4

    HUAWEICLOUD_SDK_AK: ${{ secrets.HUAWEICLOUD_SDK_AK }}

    HUAWEICLOUD_SDK_SK: ${{ secrets.HUAWEICLOUD_SDK_SK }}

  run: |

    hcloud sts GetCallerIdentity \

        --cli-region="${HUAWEICLOUD_SDK_REGION}" \

        --cli-access-key="${HUAWEICLOUD_SDK_AK}" \

        --cli-secret-key="${HUAWEICLOUD_SDK_SK}" \

        | jq -C

```

## Inputs

ID | Type | Default | Description

--- | --- | --- | ---

`agree-privacy` | Boolean | `true` | Whether to accept the [privacy statement](https://support.huaweicloud.com/productdesc-hcli/hcli_024.html) during KooCLI installation.

`check-version` | Boolean | `true` | Whether to check the [KooCLI version](https://support.huaweicloud.com/usermanual-hcli/hcli_04_004.html) after installation. Requires `agree-privacy` to be `true`.

`base-url` | String | `https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/` | Base URL for downloading the [official KooCLI binaries](https://support.huaweicloud.com/qs-hcli/hcli_02_003_02.html). Set this to an internal mirror if needed.

## Outputs

ID | Type | Description | Example

--- | --- | --- | ---

`url` | String | The URL used to download the KooCLI binary. | `https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/huaweicloud-cli-linux-amd64.tar.gz`

`path` | String | The path to the KooCLI binary on the runner. | `/usr/local/bin/hcloud`

`version` | String | The detected KooCLI version. | `Current KooCLI version: 7.2.2`