Menu de documentation +
Documentation/Démarrage rapide

Démarrage rapide

Installez un exécutable, ouvrez le TUI et émettez un kubeconfig indépendant depuis un contexte Kubernetes existant. kticket ne modifie pas le kubeconfig administrateur et n’ajoute rien au plan de contrôle.

Prérequis

  • Linux, macOS ou Windows sur amd64 ou arm64.
  • Un kubeconfig administrateur fonctionnel et un serveur API Kubernetes accessible.
  • Droits de lecture sur les espaces de noms et ressources RBAC, de création de ServiceAccount, de liaison et de serviceaccounts/token.

Installer

Téléchargez le fichier adapté à votre plateforme et architecture depuis la page de téléchargement. Extrayez l’archive tar.gz pour Linux ou zip pour macOS pour obtenir kticket ; Windows propose un téléchargement exe direct.

# Linux amd64
tar -xzf kticket_linux_amd64.tar.gz
mv kticket /usr/local/bin/kticket
kticket --help

Chaque téléchargement est accompagné de son fichier <filename>.sha256. Vérifiez-le avant l’extraction ou l’installation.

Activer avant d’émettre des identifiants

Émettre des kubeconfigs et ajouter des autorisations exige une licence valide. Obtenez l’ID de cette machine, puis suivez achat et activation de licence pour installer le fichier reçu par e-mail. Sans activation, vous pouvez explorer le TUI, consulter les comptes et révoquer l’accès.

kticket license machine-id
kticket license install /path/to/kticket-license.ktlicense
kticket license status

Ouvrir l’interface terminal

Lancez kticket sans sous-commande, puis choisissez un cluster et une action. F2 permet de choisir parmi six langues en conservant le brouillon.

kticket

Choisissez les comptes, autorisations, durée et dossier de sortie. Confirmez avant l’émission.

Utiliser la CLI dans un script

Utilisez la CLI pour émettre depuis un script. Cette commande accorde à alice un accès en lecture dans l’espace de noms existant app-prod et demande huit heures de validité. Le ClusterRole view doit exister.

kticket issue --context my-cluster --username alice \
  --access namespace --role view --role-namespace app-prod \
  --duration 8h --output ./alice.kubeconfig

Tester le fichier généré sans modifier votre kubeconfig actuel :

kubectl --kubeconfig ./alice.kubeconfig \
  get pods --namespace app-prod

Inspecter et révoquer

kticket list --context my-cluster --credentials
kticket access list --context my-cluster --username alice
kticket revoke --context my-cluster --username alice

Remarque : Les commandes d’écriture CLI s’exécutent immédiatement, sans confirmation. Utilisez le TUI pour vérifier avant application.

Pour aller plus loin

Lisez comptes, identifiants et permissions avant l’utilisation en production. Référence CLI décrit toutes les options ; guide de l’interface terminal couvre les lots et la navigation au clavier.