Instale e configure a ferramenta saectl - Serverless App Engine: Central de Documentação do Alibaba Cloud

O saectl (Serverless Application Engine Control Tool) é uma interface de linha de comando para implantar e gerenciar aplicações no SAE. Este guia orienta você na instalação do saectl, na configuração de credenciais e na ativação do autocompletar do shell.

Pré-requisitos

Antes de começar, verifique se você tem:

Uma conta do Serverless Application Engine (SAE) ativada com as permissões necessárias. Consulte Preparações para obter detalhes.
Um AccessKey ID e um AccessKey secret. Consulte Criar um par de AccessKey.

Instale o saectl

Baixe o pacote correspondente ao seu sistema operacional e arquitetura e mova o binário para o seu PATH.

macOS

Baixe

Arquitetura	Pacote
x86-64	saectl-v0.1.10-darwin-amd64.tar.gz
ARM64	saectl-v0.1.10-darwin-arm64.tar.gz

Instalação

Descompacte o pacote baixado. O diretório extraído contém o saectl.
Mova o binário para o caminho de ferramentas do sistema:
```
mv ./saectl /usr/local/bin
```

Linux

Baixe

Arquitetura	Pacote
x86-64	saectl-v0.1.10-linux-amd64.tar.gz
ARM64	saectl-v0.1.10-linux-arm64.tar.gz

Instalação

Descompacte o pacote baixado:
```
tar -zxvf <package-file-name>
```
O diretório extraído contém o saectl.
Mova o binário para o caminho de ferramentas do sistema:
```
mv ./saectl /usr/local/bin
```

Windows

Baixe

Arquitetura	Pacote
x86-64	saectl-v0.1.10-windows-amd64.zip
ARM64	saectl-v0.1.10-windows-arm64.zip

Instalação

Descompacte o pacote baixado. O diretório extraído contém o saectl.exe.
Adicione o caminho do diretório extraído à variável de ambiente do sistema PATH.

Verifique a instalação

Execute o seguinte comando:

saectl version

Se o comando retornar as informações de versão da ferramenta saectl, a instalação foi concluída com sucesso.

Obtenha ajuda

Use a flag --help com qualquer comando para visualizar as opções disponíveis:

saectl --help — lista os comandos disponíveis, como get, describe e apply
saectl apply --help — exibe os parâmetros do comando apply, como -f e -o

Notas de versão

Versão	Data de lançamento	Alterações
v0.1.10	2026-01-27	Adição do autocompletar de comandos
v0.1.9	2025-12-25	Correção de um bug no comando `exec` para o site internacional da Alibaba Cloud
v0.1.8	2025-11-17	Correção de um bug no comando `convert`
v0.1.7	2025-07-11	Suporte a conversão em lote no comando `convert`; correção de bugs
v0.1.6	2025-06-30	Inclusão do comando `convert`: `saectl convert -f input.yaml -o output.yaml` converte um arquivo YAML do Kubernetes para um arquivo YAML do SAE
v0.1.5	2025-05-23	Adição de comandos relacionados a credenciais
v0.1.4	2024-02-07	Renomeação de `kubectl-sae` para `saectl`
v0.1.3	2024-12-24	Ajuste do timeout do cliente para 60 s para resolver erros de tempo limite
v0.1.2	2024-11-20	Inclusão do comando `saectl upload`; melhoria na saída do `saectl version`
v0.1.1	2024-11-11	Verificação de consistência de namespace quando `-n` é especificado; uso do namespace do arquivo YAML quando `-n` não é especificado

Configure o saectl

O saectl exige três variáveis de ambiente para gerenciar recursos do SAE: seu AccessKey ID, AccessKey secret e a região de implantação da aplicação.

Variável	Descrição	Exemplo
`ALICLOUD_ACCESS_KEY`	Seu AccessKey ID	`LTAI5tXxx...`
`ALICLOUD_SECRET_KEY`	Seu AccessKey secret	`xXxXxXx...`
`ALICLOUD_REGION`	Região de implantação da sua aplicação	`cn-beijing`

Linux ou macOS

Execute echo $SHELL para verificar seu shell padrão e siga as etapas correspondentes.

Zsh

Anexe as variáveis de ambiente ao arquivo ~/.zshrc:

echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.zshrc

Substitua YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET e cn-beijing pelos seus valores reais.

Aplique as alterações:
```
source ~/.zshrc
```
Abra uma nova janela de terminal e verifique se as variáveis foram definidas:
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Bash

Anexe as variáveis de ambiente ao arquivo ~/.bashrc:

echo "export ALICLOUD_ACCESS_KEY='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export ALICLOUD_SECRET_KEY='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc
echo "export ALICLOUD_REGION='cn-beijing'" >> ~/.bashrc

Substitua YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET e cn-beijing pelos seus valores reais.

Aplique as alterações:
```
source ~/.bashrc
```
Abra uma nova janela de terminal e verifique se as variáveis foram definidas:
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Windows

Este exemplo utiliza o Prompt de Comando (CMD).

Execute os seguintes comandos:

setx ALICLOUD_ACCESS_KEY "YOUR_ACCESS_KEY_ID"
setx ALICLOUD_SECRET_KEY "YOUR_ACCESS_KEY_SECRET"
setx ALICLOUD_REGION "cn-beijing"

Substitua YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET e cn-beijing pelos seus valores reais.

Abra uma nova janela do Prompt de Comando e verifique se as variáveis foram definidas:
```
echo %ALICLOUD_ACCESS_KEY%, %ALICLOUD_SECRET_KEY%, %ALICLOUD_REGION%
```

Verifique a configuração

Execute o seguinte comando:

saectl get ns

Se o comando retornar as informações de namespace da região de implantação da aplicação especificada na sua conta, a ferramenta saectl estará configurada corretamente.

Configure o autocompletar do shell

O saectl oferece suporte a autocompletar para Bash, Zsh, Fish e PowerShell. Após a configuração, pressione Tab para completar comandos, tipos de recursos, nomes de recursos e parâmetros.

Instale o autocompletar

Bash

# Generate the completion script
saectl completion bash > ~/.saectl-completion.bash

# Add it to .bashrc
echo 'source ~/.saectl-completion.bash' >> ~/.bashrc

# Apply the changes immediately
source ~/.bashrc

O Bash padrão no macOS está desatualizado. Use o Zsh ou atualize o Bash com o Homebrew:

brew install bash-completion@2
saectl completion bash > $(brew --prefix)/etc/bash_completion.d/saectl

Zsh

# Generate the completion script
saectl completion bash > ~/.saectl-completion.bash

# Add it to .zshrc (using bashcompinit compatibility mode)
cat >> ~/.zshrc << 'EOF'
autoload -U +X bashcompinit && bashcompinit
source ~/.saectl-completion.bash
EOF

# Apply the changes immediately
source ~/.zshrc

Fish

# Generate the completion script (takes effect automatically)
saectl completion fish > ~/.config/fish/completions/saectl.fish

PowerShell

# Generate the completion script
saectl completion powershell | Out-String | Invoke-Expression

# Add it to your profile to make it permanent
saectl completion powershell >> $PROFILE

Use o autocompletar

Após a instalação, digite saectl no terminal e pressione Tab para acionar o autocompletar. Os seguintes preenchimentos são suportados:

Tipo	Como acionar	Exemplos
Comandos	`saectl` + Tab	`get`, `create`, `delete`, `apply`, `describe`, `logs`, `exec`
Tipos de recursos	`saectl get` + Tab	`namespaces`, `deployments`, `pods`, `services`, `configmaps`, `secrets`, `ingresses`
Nomes de recursos	Após um tipo de recurso, pressione Tab	Nomes específicos de recursos no namespace atual
Parâmetros	`--` + Tab	`--namespace`, `--output`, `--all-namespaces`, `--selector`
Nomes de contêineres	Ao usar `logs` ou `exec`, pressione Tab	Nomes dos contêineres no pod

Solucione problemas de autocompletar

Caso o autocompletar não funcione, limpe o cache de conclusão:

# Zsh
rm -f ~/.zcompdump*
exec zsh

# Bash
hash -r

Remova o autocompletar

Bash: Exclua o arquivo ~/.saectl-completion.bash e remova a linha source do ~/.bashrc.
Zsh: Exclua o arquivo ~/.saectl-completion.bash e remova as linhas relacionadas do ~/.zshrc.
Fish: Exclua o arquivo ~/.config/fish/completions/saectl.fish.