2.2. La mise en place de l’environnement

Procédure

1. Connectez-vous à la console de gestion AWS.
2. Accédez au service ROSA.

3. Cliquez sur Commencer.

   La page Vérifier les prérequis ROSA s’ouvre.

4. Dans le cadre de l’activation ROSA, assurez-vous qu’une coche verte et une ROSA précédemment activée sont affichées.

   Dans le cas contraire, suivez ces étapes:

   1. Cliquez sur la case à cocher à côté, j’accepte de partager mes coordonnées avec Red Hat.

   2. Cliquez sur Activer ROSA.

      Après une courte attente, une coche verte et un message ROSA activé sont affichés.

5. Dans la section Quotas de service, assurez-vous qu’une vérification verte et Vos quotas répondent aux exigences de ROSA sont affichés.

   Lorsque vous voyez Vos quotas ne répondent pas aux exigences minimales, prenez note du type de quota et du minimum indiqué dans le message d’erreur. Consultez la documentation d’Amazon sur la demande d’une augmentation de quota pour des conseils. Il peut prendre plusieurs heures pour qu’Amazon approuve votre demande de quota.

6. Dans le rôle ELB lié au service, assurez-vous qu’une coche verte et AWSServiceRoleForElasticLoadBalancing existent déjà.

7. Cliquez sur Continuer vers Red Hat.

   La page Démarrer avec Red Hat OpenShift Service sur AWS (ROSA) s’ouvre dans un nouvel onglet. L’étape 1 est déjà terminée sur cette page, et vous pouvez maintenant continuer à l’étape 2.

Procédure

1. Connectez-vous à vos comptes Red Hat et AWS pour accéder à la page de téléchargement de chaque outil requis.

   1. Connectez-vous à votre compte Red Hat sur console.redhat.com.
   2. Connectez-vous à votre compte AWS sur aws.amazon.com.

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

   1. Installez le CLI AWS en suivant la documentation AWS Command Line Interface appropriée à votre poste de travail.

   2. Configurez le CLI AWS en spécifiant 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.

   3. 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>

1. Installez et configurez la dernière ROSA CLI (rosa).

   1. Accédez aux téléchargements.

   2. Cherchez Red Hat OpenShift Service sur l’interface de ligne de commande AWS ('rosa) dans la liste des outils et cliquez sur Télécharger.

      Le fichier rosa-linux.tar.gz est téléchargé sur votre emplacement de téléchargement par défaut.

   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. Déplacez le fichier binaire rosa vers un répertoire dans votre chemin d’exécution. 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 installé correctement en interrogeant la version rosa:

      $ rosa version

      Exemple de sortie

      1.2.47
      Your ROSA CLI is up to date.

1. Connectez-vous à la ROSA CLI à l’aide d’un jeton d’accès hors ligne.

   1. Exécutez la commande login:

      $ rosa login

      Exemple de sortie

      To login to your Red Hat account, get an offline access token at https://console.redhat.com/openshift/token/rosa
      ? Copy the token and paste it here:

   2. Accédez à l’URL listée dans la sortie de commande pour afficher votre jeton d’accès hors ligne.

   3. Entrez le jeton d’accès hors ligne à l’invite de ligne de commande pour vous connecter.

      ? Copy the token and paste it here: *******************
      [full token length omitted]

      Note

      À l’avenir, vous pouvez spécifier le jeton d’accès hors ligne en utilisant l’argument --token="<offline_access_token>" lorsque vous exécutez la commande de connexion rosa.

   4. Assurez-vous que vous êtes connecté et confirmez que vos informations d’identification sont correctes avant de procéder:

      $ rosa whoami

      Exemple de sortie

      AWS Account ID:               <aws_account_number>
      AWS Default Region:           us-east-1
      AWS ARN:                      arn:aws:iam::<aws_account_number>:user/<aws_user_name>
      OCM API:                      https://api.openshift.com
      OCM Account ID:               <red_hat_account_id>
      OCM Account Name:             Your Name
      OCM Account Username:         you@domain.com
      OCM Account Email:            you@domain.com
      OCM Organization ID:          <org_id>
      OCM Organization Name:        Your organization
      OCM Organization External ID: <external_org_id>

1. Installez et configurez le dernier OpenShift CLI (oc).

   1. Le ROSA CLI vous permet de télécharger le CLI oc.

      La commande suivante télécharge la dernière version du CLI dans le répertoire de travail actuel:

      $ rosa download openshift-client

   2. Extrayez le fichier binaire oc de l’archive téléchargée. L’exemple suivant extrait les fichiers d’une archive tar Linux:

      $ tar xvf openshift-client-linux.tar.gz

   3. Déplacez le binaire oc vers un répertoire dans votre chemin d’exécution. Dans l’exemple suivant, le répertoire /usr/local/bin est inclus dans le chemin d’accès de l’utilisateur:

      $ sudo mv oc /usr/local/bin/oc

   4. Assurez-vous que le CLI oc est installé correctement:

      $ rosa verify openshift-client

      Exemple de sortie

      I: Verifying whether OpenShift command-line tool is available...
      I: Current OpenShift Client Version: 4.17.3