Install and configure the saectl tool - Serverless App Engine - Centro de documentación de Alibaba Cloud

saectl (Serverless Application Engine Control Tool) es una interfaz de línea de comandos para desplegar y gestionar aplicaciones en SAE. Esta guía explica cómo instalar saectl, configurar las credenciales y habilitar el autocompletado en la shell.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

Una cuenta de Serverless Application Engine (SAE) activada y con los permisos obligatorios. Consulte Preparations para obtener más información.
Un AccessKey ID y un AccessKey secret. Consulte Create an AccessKey pair.

Instalación de saectl

Descargue el paquete correspondiente a su sistema operativo y arquitectura, y luego mueva el binario a su PATH.

macOS

Descarga

Arquitectura	Paquete
x86-64	saectl-v0.1.10-darwin-amd64.tar.gz
ARM64	saectl-v0.1.10-darwin-arm64.tar.gz

Instalación

Descomprima el paquete descargado. El directorio descomprimido contiene saectl.
Mueva el binario a la ruta de herramientas del sistema:
```
mv ./saectl /usr/local/bin
```

Linux

Descarga

Arquitectura	Paquete
x86-64	saectl-v0.1.10-linux-amd64.tar.gz
ARM64	saectl-v0.1.10-linux-arm64.tar.gz

Instalación

Descomprima el paquete descargado:
```
tar -zxvf <package-file-name>
```
El directorio descomprimido contiene saectl.
Mueva el binario a la ruta de herramientas del sistema:
```
mv ./saectl /usr/local/bin
```

Windows

Descarga

Arquitectura	Paquete
x86-64	saectl-v0.1.10-windows-amd64.zip
ARM64	saectl-v0.1.10-windows-arm64.zip

Instalación

Descomprima el paquete descargado. El directorio descomprimido contiene saectl.exe.
Agregue la ruta del directorio descomprimido a la variable de entorno del sistema PATH.

Comprobación de la instalación

Ejecute el siguiente comando:

saectl version

Si el comando devuelve la información de versión de la herramienta saectl, significa que se instaló correctamente.

Obtención de ayuda

Utilice la bandera --help con cualquier comando para consultar las opciones disponibles:

saectl --help — enumera los comandos disponibles, como get, describe y apply
saectl apply --help — muestra los parámetros del comando apply, como -f y -o

Notas de la versión

Versión	Fecha de lanzamiento	Cambios
v0.1.10	2026-01-27	Se agregó el autocompletado de comandos
v0.1.9	2025-12-25	Se corrigió un bug en el comando `exec` para el sitio internacional de Alibaba Cloud
v0.1.8	2025-11-17	Se corrigió un bug en el comando `convert`
v0.1.7	2025-07-11	Se agregó compatibilidad con la conversión por lotes en el comando `convert`; se corrigieron bugs
v0.1.6	2025-06-30	Se agregó el comando `convert`: `saectl convert -f input.yaml -o output.yaml` convierte un archivo YAML de Kubernetes a un archivo YAML de SAE
v0.1.5	2025-05-23	Se agregaron comandos relacionados con credenciales
v0.1.4	2024-02-07	Se cambió el nombre de `kubectl-sae` a `saectl`
v0.1.3	2024-12-24	Se ajustó el tiempo de espera del cliente a 60 s para resolver errores de tiempo de espera
v0.1.2	2024-11-20	Se agregó el comando `saectl upload`; se mejoró la salida de `saectl version`
v0.1.1	2024-11-11	Se agregó una comprobación de coherencia del namespace cuando se especifica `-n`; utiliza el namespace del archivo YAML cuando no se especifica `-n`

Configuración de saectl

saectl requiere tres variables de entorno para gestionar los recursos de SAE: su AccessKey ID, su AccessKey secret y la región de despliegue de la aplicación.

Variable	Descripción	Ejemplo
`ALICLOUD_ACCESS_KEY`	Su AccessKey ID	`LTAI5tXxx...`
`ALICLOUD_SECRET_KEY`	Su AccessKey secret	`xXxXxXx...`
`ALICLOUD_REGION`	La región de despliegue de su aplicación	`cn-beijing`

Linux o macOS

Ejecute echo $SHELL para comprobar su shell predeterminada y siga los pasos correspondientes.

Zsh

Agregue las variables de entorno al final de ~/.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

Reemplace YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET y cn-beijing con sus valores reales.

Aplique los cambios:
```
source ~/.zshrc
```
Abra una nueva ventana de terminal y compruebe que las variables estén configuradas:
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Bash

Agregue las variables de entorno al final de ~/.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

Reemplace YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET y cn-beijing con sus valores reales.

Aplique los cambios:
```
source ~/.bashrc
```
Abra una nueva ventana de terminal y compruebe que las variables estén configuradas:
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Windows

Este ejemplo utiliza el Símbolo del sistema (CMD).

Ejecute los siguientes comandos:

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

Reemplace YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET y cn-beijing con sus valores reales.

Abra una nueva ventana del Símbolo del sistema y compruebe que las variables estén configuradas:
```
echo %ALICLOUD_ACCESS_KEY%, %ALICLOUD_SECRET_KEY%, %ALICLOUD_REGION%
```

Comprobación de la configuración

Ejecute el siguiente comando:

saectl get ns

Si el comando devuelve la información del namespace correspondiente a la región de despliegue especificada en su cuenta, significa que la herramienta saectl se configuró correctamente.

Configuración del autocompletado en la shell

saectl admite el autocompletado para Bash, Zsh, Fish y PowerShell. Una vez configurado, presione Tab para completar comandos, tipos de recursos, nombres de recursos y parámetros.

Instalación del autocompletado

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

La versión predeterminada de Bash en macOS está desactualizada. Utilice Zsh o actualice Bash mediante 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

Uso del autocompletado

Después de la instalación, escriba saectl en la terminal y presione Tab para activar el autocompletado. Se admiten los siguientes tipos de completado:

Tipo	Cómo activarlo	Ejemplos
Comandos	`saectl` + Tab	`get`, `create`, `delete`, `apply`, `describe`, `logs`, `exec`
Tipos de recursos	`saectl get` + Tab	`namespaces`, `deployments`, `pods`, `services`, `configmaps`, `secrets`, `ingresses`
Nombres de recursos	Después de un tipo de recurso, presione Tab	Nombres específicos de recursos en el namespace actual
Parámetros	`--` + Tab	`--namespace`, `--output`, `--all-namespaces`, `--selector`
Nombres de contenedores	Al usar `logs` o `exec`, presione Tab	Nombres de contenedores en el pod

Solución de problemas de autocompletado

Si el autocompletado no funciona, limpie la caché de completado:

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

# Bash
hash -r

Eliminación del autocompletado

Bash: Elimine ~/.saectl-completion.bash y quite la línea source de ~/.bashrc.
Zsh: Elimine ~/.saectl-completion.bash y quite las líneas relacionadas de ~/.zshrc.
Fish: Elimine ~/.config/fish/completions/saectl.fish.