# ack-set-context

**Repository Path**: aliyun/ack-set-context

## Basic Information

- **Project Name**: ack-set-context
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-08
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Setting context for Kubernetes cluster of Alibaba Cloud Kubernetes Service (ACK)
Use this GitHub Action to [set context for Kubernetes cluster of Alibaba Cloud Kubernetes (ACK)](https://www.aliyun.com/product/kubernetes) or [set context for cluster of Alibaba Distributed Cloud Container Platform for Kubernetes (ACK One)](https://www.aliyun.com/product/aliware/adcp). 


Set the ```KUBECONFIG``` environment variable by cluster id for K8s cluster managed by ACK or for ACK One hub cluster.


```yaml
- uses: aliyun/ack-set-context@v1
  with:
    access-key-id: '<access key id>'
    access-key-secret: '<access key secret>'
    ## optional, supports 'ACK' or 'One', default is 'ACK'
    cluster-type: '<cluster type>'
    ## if cluster-type is 'One', please filling up ACK One Fleet cluster id
    cluster-id: '<cluster id>'
    ## optional, whether the API server address in generated kubeconfig
    ## is a private (intranet) address; default is 'false'
    private-ip-address: '<true|false>'
    ## optional, OpenAPI endpoint, e.g. https://cs.cn-hangzhou.aliyuncs.com (ACK) or
    ## https://adcp.aliyuncs.com (ACK One)
    api-endpoint: '<endpoint>'
```

Refer to the action metadata file for details about all the inputs: [action.yml](https://github.com/aliyun/ack-set-context/blob/master/action.yml)

### Prerequisite
1. Get the access-key-id and access-key-secret of Alibaba Cloud and add them as [secrets](https://developer.github.com/actions/managing-workflows/storing-secrets/) in the GitHub repository.
2. Please keep permissions of AKSK to be minimized. If cluster-type is 'One', you can refer to [Grant permissions to a RAM user](https://www.alibabacloud.com/help/en/ack/distributed-cloud-container-platform-for-kubernetes/user-guide/grant-permissions-to-a-ram-user-1?spm=a2c63.p38356.0.0.60f81fd4if2ccM) to configure AliyunAdcpReadOnlyAccess RAM permissions and RBAC role including admin or dev.