Install and configure the saectl tool - Serverless App Engine

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un compte Serverless Application Engine (SAE) activé disposant des permissions requises. Consultez la rubrique Préparatifs pour plus de détails.
Un ID AccessKey et un secret AccessKey. Consultez la documentation Créer une paire de clés AccessKey.

Installer saectl

Téléchargez le package correspondant à votre système d'exploitation et à votre architecture, puis placez le binaire dans votre PATH.

macOS

Téléchargement

Architecture	Package
x86-64	saectl-v0.1.10-darwin-amd64.tar.gz
ARM64	saectl-v0.1.10-darwin-arm64.tar.gz

Installation

Décompressez le package téléchargé. Le répertoire extrait contient saectl.
Déplacez le binaire vers le chemin des outils système :
```
mv ./saectl /usr/local/bin
```

Linux

Téléchargement

Architecture	Package
x86-64	saectl-v0.1.10-linux-amd64.tar.gz
ARM64	saectl-v0.1.10-linux-arm64.tar.gz

Installation

Décompressez le package téléchargé :
```
tar -zxvf <package-file-name>
```
Le répertoire extrait contient saectl.
Déplacez le binaire vers le chemin des outils système :
```
mv ./saectl /usr/local/bin
```

Windows

Téléchargement

Architecture	Package
x86-64	saectl-v0.1.10-windows-amd64.zip
ARM64	saectl-v0.1.10-windows-arm64.zip

Installation

Décompressez le package téléchargé. Le répertoire extrait contient saectl.exe.
Ajoutez le chemin du répertoire extrait à la variable d'environnement système PATH.

Vérifier l'installation

Exécutez la commande suivante :

saectl version

Si la commande renvoie les informations de version de l'outil saectl, l'installation a réussi.

Obtenir de l'aide

Utilisez l'indicateur --help avec n'importe quelle commande pour afficher les options disponibles :

saectl --help : répertorie les commandes disponibles telles que get, describe et apply
saectl apply --help : répertorie les paramètres de la commande apply, tels que -f et -o

Notes de version

Version	Date de publication	Modifications
v0.1.10	2026-01-27	Ajout de l'autocomplétion des commandes
v0.1.9	2025-12-25	Correction d'un bug dans la commande `exec` pour le site international Alibaba Cloud
v0.1.8	2025-11-17	Correction d'un bug dans la commande `convert`
v0.1.7	2025-07-11	Ajout de la prise en charge de la conversion par lot dans la commande `convert` ; correction de bugs
v0.1.6	2025-06-30	Ajout de la commande `convert` : `saectl convert -f input.yaml -o output.yaml` convertit un fichier YAML Kubernetes en fichier YAML SAE
v0.1.5	2025-05-23	Ajout de commandes liées aux identifiants
v0.1.4	2024-02-07	Renommage de `kubectl-sae` en `saectl`
v0.1.3	2024-12-24	Ajustement du délai d'expiration du client à 60 s pour résoudre les erreurs de délai d'expiration
v0.1.2	2024-11-20	Ajout de la commande `saectl upload` ; amélioration de la sortie de `saectl version`
v0.1.1	2024-11-11	Ajout d'une vérification de cohérence du namespace lorsque `-n` est spécifié ; utilise le namespace du fichier YAML lorsque `-n` n'est pas spécifié

Configurer saectl

saectl nécessite trois variables d'environnement pour gérer les ressources SAE : votre ID AccessKey, votre secret AccessKey et la région de déploiement de vos applications.

Variable	Description	Exemple
`ALICLOUD_ACCESS_KEY`	Votre ID AccessKey	`LTAI5tXxx...`
`ALICLOUD_SECRET_KEY`	Votre secret AccessKey	`xXxXxXx...`
`ALICLOUD_REGION`	Votre région de déploiement d'application	`cn-beijing`

Linux ou macOS

Exécutez echo $SHELL pour vérifier votre shell par défaut, puis suivez les étapes correspondant à votre shell.

Zsh

Ajoutez les variables d'environnement à la fin du fichier ~/.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

Remplacez YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET et cn-beijing par vos valeurs réelles.

Appliquez les modifications :
```
source ~/.zshrc
```
Ouvrez une nouvelle fenêtre de terminal et vérifiez que les variables sont définies :
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Bash

Ajoutez les variables d'environnement à la fin du fichier ~/.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

Remplacez YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET et cn-beijing par vos valeurs réelles.

Appliquez les modifications :
```
source ~/.bashrc
```
Ouvrez une nouvelle fenêtre de terminal et vérifiez que les variables sont définies :
```
echo $ALICLOUD_ACCESS_KEY, $ALICLOUD_SECRET_KEY, $ALICLOUD_REGION
```

Windows

Cet exemple utilise l'invite de commandes (CMD).

Exécutez les commandes suivantes :

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

Remplacez YOUR_ACCESS_KEY_ID, YOUR_ACCESS_KEY_SECRET et cn-beijing par vos valeurs réelles.

Ouvrez une nouvelle fenêtre d'invite de commandes et vérifiez que les variables sont définies :
```
echo %ALICLOUD_ACCESS_KEY%, %ALICLOUD_SECRET_KEY%, %ALICLOUD_REGION%
```

Vérifier la configuration

Exécutez la commande suivante :

saectl get ns

Si la commande renvoie les informations du namespace pour la région de déploiement spécifiée dans votre compte, la configuration de l'outil saectl a réussi.

Configurer l'autocomplétion du shell

saectl prend en charge l'autocomplétion pour Bash, Zsh, Fish et PowerShell. Une fois configurée, appuyez sur Tab pour compléter les commandes, les types de ressources, les noms de ressources et les paramètres.

Installer l'autocomplétion

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 version par défaut de Bash sur macOS est obsolète. Utilisez Zsh ou mettez à niveau Bash avec 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

Utiliser l'autocomplétion

Après l'installation, saisissez saectl dans le terminal et appuyez sur Tab pour déclencher l'autocomplétion. Les compléments suivants sont pris en charge :

Type	Comment déclencher	Exemples
Commandes	`saectl` + Tab	`get`, `create`, `delete`, `apply`, `describe`, `logs`, `exec`
Types de ressources	`saectl get` + Tab	`namespaces`, `deployments`, `pods`, `services`, `configmaps`, `secrets`, `ingresses`
Noms de ressources	Après un type de ressource, appuyez sur Tab	Noms de ressources spécifiques dans le namespace actuel
Paramètres	`--` + Tab	`--namespace`, `--output`, `--all-namespaces`, `--selector`
Noms de conteneurs	Lors de l'utilisation de `logs` ou `exec`, appuyez sur Tab	Noms de conteneurs dans le pod

Dépanner l'autocomplétion

Si l'autocomplétion ne fonctionne pas, purgez le cache d'autocomplétion :

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

# Bash
hash -r

Supprimer l'autocomplétion

Bash : Supprimez ~/.saectl-completion.bash et retirez la ligne source du fichier ~/.bashrc.
Zsh : Supprimez ~/.saectl-completion.bash et retirez les lignes associées du fichier ~/.zshrc.
Fish : Supprimez ~/.config/fish/completions/saectl.fish.