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

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

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

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   $ rosa version

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   1.2.15
   Your ROSA CLI is up to date.

   Copy to Clipboard Toggle word wrap

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

        Copy to Clipboard Toggle word wrap
     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

        Copy to Clipboard Toggle word wrap
     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

        Copy to Clipboard Toggle word wrap

     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"

        Copy to Clipboard Toggle word wrap
     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

        Copy to Clipboard Toggle word wrap
     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

        Copy to Clipboard Toggle word wrap
     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>

   Copy to Clipboard Toggle word wrap

2. Créer le cluster ROSA:

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

Procédure

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

   $ rosa version

   Copy to Clipboard Toggle word wrap

   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/

   Copy to Clipboard Toggle word wrap

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

   $ rosa download rosa

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap