如何安装与配置kubectl-sae工具_Serverless 应用引擎(SAE)-阿里云帮助中心

如果您初次使用kubectl-sae工具，请参考本文完成工具的安装与配置。

前提条件

安装kubectl-sae工具

请根据您的操作系统类型选择相关的安装包和安装方式。

操作系统	安装包	安装方式
macOS	kubectl-sae-v0.1.2-darwin-amd64.tar.gz（X86-64位系统） kubectl-sae-v0.1.2-darwin-arm64.tar.gz（ARM-64位系统）	将压缩包下载到本地并解压，解压后的路径中包含`kubectl-sae`。命令行中进入`kubectl-sae`所在路径，执行`mv ./kubectl-sae /usr/local/bin`将其移动到系统工具所在路径。
Linux	kubectl-sae-v0.1.2-linux-amd64.tar.gz（X86-64位系统） kubectl-sae-v0.1.2-linux-arm64.tar.gz（ARM-64位系统）	将压缩包下载到本地，在命令行中运行如下命令`tar -zxvf ${压缩包文件名}`将压缩包解压，解压后的路径中包含`kubectl-sae`。命令行中进入`kubectl-sae`所在路径，执行`mv ./kubectl-sae /usr/local/bin`将其移动到系统工具所在路径。
Windows	kubectl-sae-v0.1.2-windows-amd64.zip（X86-64位系统） kubectl-sae-v0.1.2-windows-arm64.zip（ARM-64位系统）	将压缩包下载到本地并解压，解压后的路径中包含`kubectl-sae.exe`。将解压后的路径添加到`PATH`系统环境变量。

验证安装成功

在命令行中运行kubectl-sae version，返回kubectl-sae工具的相关版本信息，表明已成功安装kubectl-sae工具。

查看帮助信息

运行命令的过程中，可以通过--help参数查询帮助信息，例如：

kubectl-sae --help返回kubectl-sae后面可以跟随的命令，例如get、describe、apply。
kubectl-sae apply --help返回kubectl-sae apply后面可以跟随的参数，例如-f、-o。

配置kubectl-sae工具

kubectl-sae工具需要获取在SAE部署应用和管理资源的权限，因此需要在环境变量中配置阿里云账号的AccessKey ID、AccessKey Secret、以及应用部署地域等信息。

获取AccessKey ID和AccessKey Secret

您需要创建AccessKey，并记录AccessKey ID和AccessKey Secret。

配置环境变量

请根据您的操作系统选择配置方式。

Linux系统或macOS系统

在终端中执行echo $SHELL命令，查看默认Shell类型。根据默认Shell类型选择配置方式。

Zsh

执行以下命令来将环境变量设置追加到~/.zshrc 文件中。

# 用您的 AccessKey ID 代替 YOUR_ACCESS_KEY_ID
echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
# 用您的 AccessKey Secret 代替 YOUR_ACCESS_KEY_SECRET
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
# 用您的 应用部署地域 代替 cn-beijing
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.zshrc

执行以下命令，使变更生效。
```
source ~/.zshrc
```
重新打开一个终端窗口，运行以下命令检查环境变量是否生效。
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Bash

执行以下命令来将环境变量设置追加到~/.bashrc 文件中。

# 用您的 AccessKey ID 代替 YOUR_ACCESS_KEY_ID
echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
# 用您的 AccessKey Secret 代替 YOUR_ACCESS_KEY_SECRET
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc
# 用您的 应用部署地域 代替 cn-beijing
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.bashrc

执行以下命令，使变更生效。
```
source ~/.bashrc
```
重新打开一个终端窗口，运行以下命令检查环境变量是否生效。
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Windows系统

本文以使用CMD命令行为例。

在CMD中运行以下命令。

# 用您的 AccessKey ID 代替 YOUR_ACCESS_KEY_ID
setx ALICLOUD_ACCESS_KEY "YOUR_ACCESS_KEY_ID"
# 用您的 AccessKey Secret 代替 YOUR_ACCESS_KEY_SECRET
setx ALICLOUD_SECRET_KEY "YOUR_ACCESS_KEY_SECRET"
# 用您的 应用部署地域 代替 cn-beijing
setx ALICLOUD_REGION "cn-beijing"

重新打开一个CMD窗口，运行以下命令检查环境变量是否生效。
```
echo %ALICLOUD_ACCESS_KEY%, %ALICLOUD_SECRET_KEY%, %ALICLOUD_REGION%
```

验证配置成功

在命令行中运行kubectl-sae get ns，返回账号中指定应用部署地域的命名空间信息，表明已成功配置kubectl-sae工具。