11.5. Installation du service Red Hat OpenShift sur AWS (ROSA) CLI, rosa

Procédure

1. Installez rosa, le service Red Hat OpenShift sur l’interface de ligne de commande AWS (CLI).

   1. Cliquez ici pour télécharger la dernière version de la ROSA CLI pour votre système d’exploitation.
   2. Facultatif: Renommer le fichier exécutable que vous avez téléchargé sur rosa. Cette documentation utilise rosa pour se référer au fichier exécutable.

   3. En option: Ajoutez rosa à votre chemin.

      Exemple :

      $ mv rosa /usr/local/bin/rosa

      Copy to Clipboard Toggle word wrap

   4. Entrez la commande suivante pour vérifier votre installation:

      $ rosa

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      Command line tool for Red Hat OpenShift Service on AWS.
      For further documentation visit https://access.redhat.com/documentation/en-us/red_hat_openshift_service_on_aws
      
      Usage:
        rosa [command]
      
      Available Commands:
        completion  Generates completion scripts
        create      Create a resource from stdin
        delete      Delete a specific resource
        describe    Show details of a specific resource
        download    Download necessary tools for using your cluster
        edit        Edit a specific resource
        grant       Grant role to a specific resource
        help        Help about any command
        init        Applies templates to support Red Hat OpenShift Service on AWS
        install     Installs a resource into a cluster
        link        Link a ocm/user role from stdin
        list        List all resources of a specific type
        login       Log in to your Red Hat account
        logout      Log out
        logs        Show installation or uninstallation logs for a cluster
        revoke      Revoke role from a specific resource
        uninstall   Uninstalls a resource from a cluster
        unlink      UnLink a ocm/user role from stdin
        upgrade     Upgrade a resource
        verify      Verify resources are configured correctly for cluster install
        version     Prints the version of the tool
        whoami      Displays user account information
      
      Flags:
            --color string   Surround certain characters with escape sequences to display them in color on the terminal. Allowed options are [auto never always] (default "auto")
            --debug          Enable debug mode.
        -h, --help           help for rosa
      
      Use "rosa [command] --help" for more information about a command.

      Copy to Clipboard Toggle word wrap

   5. Facultatif: Générer les scripts d’achèvement de la commande pour le ROSA CLI. L’exemple suivant génère les scripts d’achèvement Bash pour une machine Linux:

      $ rosa completion bash | sudo tee /etc/bash_completion.d/rosa

      Copy to Clipboard Toggle word wrap

   6. Facultatif: Activer l’achèvement de la commande pour le ROSA CLI à partir de votre terminal existant. L’exemple suivant permet l’achèvement de Bash pour rosa dans un terminal existant sur une machine Linux:

      $ source /etc/bash_completion.d/rosa

      Copy to Clipboard Toggle word wrap

2. Connectez-vous à votre compte Red Hat avec rosa.

   1. Entrez la commande suivante.

      $ rosa login

      Copy to Clipboard Toggle word wrap

   2. <my_offline_access_token> par votre jeton.

      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: <my-offline-access-token>

      Copy to Clipboard Toggle word wrap

      Exemple de sortie continue

      I: Logged in as 'rh-rosa-user' on 'https://api.openshift.com'

      Copy to Clipboard Toggle word wrap

3. Entrez la commande suivante pour vérifier que votre compte AWS dispose des autorisations nécessaires.

   $ rosa verify permissions

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   I: Validating SCP policies...
   I: AWS SCP policies ok

   Copy to Clipboard Toggle word wrap

   Note

   Cette commande vérifie les autorisations uniquement pour les clusters ROSA qui n’utilisent pas AWS Security Token Service (STS).

4. Assurez-vous que votre compte AWS dispose du quota nécessaire pour déployer un service Red Hat OpenShift sur le cluster AWS.

   $ rosa verify quota --region=us-west-2

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   I: Validating AWS quota...
   I: AWS quota ok

   Copy to Clipboard Toggle word wrap

   Note

   Il arrive que votre quota AWS varie selon les régions. En cas d’erreur, essayez une autre région.

   Lorsque vous devez augmenter votre quota, accédez à votre console AWS et demandez une augmentation de quota pour le service qui a échoué.

   Après le passage des autorisations et des contrôles des quotas, passez à l’étape suivante.

5. Créez votre compte AWS pour le déploiement de clusters:

   1. Exécutez la commande suivante pour vérifier que vos identifiants Red Hat et AWS sont configurés correctement. Assurez-vous que votre ID de compte AWS, votre région par défaut et votre ARN correspondent à ce que vous attendez. En toute sécurité, vous pouvez ignorer les lignes commençant par OCM pour l’instant.

      $ rosa whoami

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      AWS Account ID:               000000000000
      AWS Default Region:           us-east-2
      AWS ARN:                      arn:aws:iam::000000000000:user/hello
      OCM API:                      https://api.openshift.com
      OCM Account ID:               1DzGIdIhqEWyt8UUXQhSoWaaaaa
      OCM Account Name:             Your Name
      OCM Account Username:         you@domain.com
      OCM Account Email:            you@domain.com
      OCM Organization ID:          1HopHfA2hcmhup5gCr2uH5aaaaa
      OCM Organization Name:        Red Hat
      OCM Organization External ID: 0000000

      Copy to Clipboard Toggle word wrap

   2. Initialisez votre compte AWS. Cette étape exécute un modèle CloudFormation qui prépare votre compte AWS pour le déploiement et la gestion de clusters. Cette étape prend généralement 1-2 minutes à compléter.

      $ rosa init

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      I: Logged in as 'rh-rosa-user' on 'https://api.openshift.com'
      I: Validating AWS credentials...
      I: AWS credentials are valid!
      I: Validating SCP policies...
      I: AWS SCP policies ok
      I: Validating AWS quota...
      I: AWS quota ok
      I: Ensuring cluster administrator user 'osdCcsAdmin'...
      I: Admin user 'osdCcsAdmin' created successfully!
      I: Verifying whether OpenShift command-line tool is available...
      E: OpenShift command-line tool is not installed.
      Run 'rosa download oc' to download the latest version, then add it to your PATH.

      Copy to Clipboard Toggle word wrap

6. Installez l’OpenShift CLI (oc) à partir du ROSA CLI.

   1. Entrez cette commande pour télécharger la dernière version du CLI oc:

      $ rosa download oc

      Copy to Clipboard Toggle word wrap
   2. Après avoir téléchargé le CLI oc, décompressez-le et ajoutez-le à votre chemin.

   3. Entrez cette commande pour vérifier que le CLI oc est installé correctement:

      $ rosa verify oc

      Copy to Clipboard Toggle word wrap