Chapitre 8. À PROPOS DE ROSA CLI

Procédure

1. Installez et configurez les derniers CLI AWS (aws).

   1. Suivez la documentation AWS Command Line Interface pour installer et configurer le CLI AWS pour votre système d’exploitation.

      Indiquez aws_access_key_id, aws_secret_access_key et région dans le fichier .aws/credentials. Consultez les bases de configuration AWS dans la documentation AWS.

      Note

      En option, vous pouvez utiliser la variable d’environnement AWS_DEFAULT_REGION pour définir la région AWS par défaut.

   2. Interrogez l’API AWS pour vérifier si le CLI AWS est installé et configuré correctement:

      $ aws sts get-caller-identity  --output text

      Exemple de sortie

      <aws_account_id>    arn:aws:iam::<aws_account_id>:user/<username>  <aws_user_id>

2. Consultez la dernière version de la ROSA CLI (rosa) pour votre système d’exploitation à partir de la page Téléchargements sur OpenShift Cluster Manager.

3. Extrayez le fichier binaire rosa de l’archive téléchargée. L’exemple suivant extrait le binaire d’une archive tar Linux:

   $ tar xvf rosa-linux.tar.gz

4. Ajoutez rosa à votre chemin. Dans l’exemple suivant, le répertoire /usr/local/bin est inclus dans le chemin d’accès de l’utilisateur:

   $ sudo mv rosa /usr/local/bin/rosa

5. Assurez-vous que le ROSA CLI est correctement installé en interrogeant la version rosa:

   $ rosa version

   Exemple de sortie

   1.2.15
   Your ROSA CLI is up to date.

6. Facultatif: Activer la réalisation de l’onglet pour le ROSA CLI. Avec l’achèvement de l’onglet activé, vous pouvez appuyer deux fois sur la touche Tab pour compléter automatiquement les sous-commandes et recevoir des suggestions de commande:

   • Activer l’achèvement de l’onglet persistant pour Bash sur un hôte Linux:

     1. Générez un fichier de configuration d’achèvement de l’onglet rosa pour Bash et enregistrez-le dans votre répertoire /etc/bash_completion.d/:

        # rosa completion bash > /etc/bash_completion.d/rosa

     2. Ouvrez un nouveau terminal pour activer la configuration.

   • Activer l’achèvement de l’onglet persistant pour Bash sur un hôte macOS:

     1. Générez un fichier de configuration d’achèvement de l’onglet rosa pour Bash et enregistrez-le dans votre répertoire /usr/local/etc/bash_completion.d/:

        $ rosa completion bash > /usr/local/etc/bash_completion.d/rosa

     2. Ouvrez un nouveau terminal pour activer la configuration.

   • Afin de permettre l’achèvement de l’onglet persistant pour Zsh:

     1. Lorsque l’achèvement de l’onglet n’est pas activé pour votre environnement Zsh, activez-le en exécutant la commande suivante:

        $ echo "autoload -U compinit; compinit" >> ~/.zshrc

     2. Générez un fichier de configuration d’achèvement de l’onglet rosa pour Zsh et enregistrez-le dans le premier répertoire de votre chemin d’accès:

        $ rosa completion zsh > "${fpath[1]}/_rosa"

     3. Ouvrez un nouveau terminal pour activer la configuration.

   • Afin de permettre l’achèvement persistant de l’onglet pour les poissons:

     1. Générez un fichier de configuration d’achèvement de l’onglet rosa pour les poissons et enregistrez-le dans votre répertoire ~/.config/fish/completions/

        $ rosa completion fish > ~/.config/fish/completions/rosa.fish

     2. Ouvrez un nouveau terminal pour activer la configuration.

   • Activer l’achèvement de l’onglet persistant pour PowerShell:

     1. Générez un fichier de configuration d’achèvement de l’onglet rosa pour PowerShell et enregistrez-le dans un fichier nommé rosa.ps1:

        PS> rosa completion powershell | Out-String | Invoke-Expression

     2. Sourcez le fichier rosa.ps1 à partir de votre profil PowerShell.
   Note

   Consultez le menu d’aide pour plus d’informations sur la configuration de l’onglet rosa en exécutant la commande rosa Complete --help.

Procédure

1. Initialisez rosa en utilisant un jeton hors ligne Red Hat OpenShift Cluster Manager de Red Hat:

   $ rosa init --token=<token>

2. Créer le cluster ROSA:

   $ rosa create cluster --cluster-name=<cluster_name>

3. Ajouter un fournisseur d’identité (IDP):

   $ rosa create idp --cluster=<cluster_name> --type=<identity_provider> [arguments]

4. Ajouter un utilisateur dédié-admin:

   $ rosa grant user dedicated-admin --user=<idp_user_name> --cluster=<cluster_name>

Procédure

1. Confirmez qu’une nouvelle version de la ROSA CLI (rosa) est disponible:

   $ rosa version

   Exemple de sortie

   1.2.12
   There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

2. La dernière version compatible de la ROSA CLI:

   $ rosa download rosa

   Cette commande télécharge une archive appelée rosa-*.tar.gz dans le répertoire actuel. Le nom exact du fichier dépend de votre système d’exploitation et de l’architecture du système.

3. Extraire le contenu de l’archive:

   $ tar -xzf rosa-linux.tar.gz

4. Installez la nouvelle version de la ROSA CLI en déplaçant le fichier extrait dans votre chemin. Dans l’exemple suivant, le répertoire /usr/local/bin est inclus dans le chemin d’accès de l’utilisateur:

   $ sudo mv rosa /usr/local/bin/rosa