第1章 Red Hat OpenShift Service on AWS クイックスタートガイド

手順

1. AWS 管理コンソール にログインします。
2. ROSA service に移動します。

3. Get started をクリックします。

   Verify ROSA prerequisites ページが開きます。

4. ROSA enablement の下で、緑色のチェックマークと You previously enabled ROSA が表示されていることを確認します。

   そうでない場合は、次の手順に従います。

   1. I agree to share my contact information with Red Hat の横にあるチェックボックスを選択します。

   2. Enable ROSA をクリックします。

      少し待つと、緑色のチェックマークと You enabled ROSA メッセージが表示されます。

5. Service Quotas の下に、緑色のチェックと Your quotas meet the requirements for ROSA が表示されていることを確認します。

   Your quotas don’t meet the minimum requirements と表示される場合は、エラーメッセージに記載されているクォータの種類と最小値をメモしてください。ガイダンスは、割り当て増加のリクエスト に関する Amazon のドキュメントを参照してください。Amazon が割り当てリクエストを承認するまでに数時間かかる場合があります。

6. ELB service-linked role の下で、緑色のチェックマークと AWSServiceRoleForElasticLoadBalancing already exists が表示されていることを確認します。

7. Continue to Red Hat をクリックします。

   Get started with Red Hat OpenShift Service on AWS (ROSA) ページが新しいタブで開きます。このページのステップ 1 はすでに完了しており、ステップ 2 に進むことができます。

手順

1. 必要な各ツールのダウンロードページにアクセスするには、Red Hat および AWS アカウントにログインします。

   1. console.redhat.com で Red Hat アカウントにログインします。
   2. aws.amazon.com で AWS アカウントにログインします。

2. 最新の AWS CLI (aws) をインストールして設定します。

   1. ワークステーションに適した AWS コマンドラインインターフェイス のドキュメントに従って、AWS CLI をインストールします。

   2. .aws/credentials ファイルで aws_access_key_id、aws_secret_access_key、および region を指定して AWS CLI を設定します。詳細は、AWS ドキュメントの AWS 設定の基本 を参照してください。

      注記

      オプションで AWS_DEFAULT_REGION 環境変数を使用して、デフォルトの AWS リージョンを設定できます。

   3. AWS API に問い合わせて、AWS CLI が正しくインストールおよび設定されているかどうかを確認します。

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

      Copy to Clipboard Toggle word wrap

      出力例

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

      Copy to Clipboard Toggle word wrap

3. 最新の ROSA CLI をインストールして設定します。

   1. Downloads に移動します。

   2. ツールのリストから Red Hat OpenShift Service on AWS command line interface (rosa) を見つけて、Download をクリックします。

      rosa-linux.tar.gz ファイルはデフォルトのダウンロード先にダウンロードされます。

   3. ダウンロードしたアーカイブから rosa バイナリーファイルを展開します。次の例では、Linux tar アーカイブからバイナリーを展開します。

      $ tar xvf rosa-linux.tar.gz

      Copy to Clipboard Toggle word wrap

   4. rosa バイナリーファイルを実行パス内のディレクトリーに移動します。以下の例では、/usr/local/bin ディレクトリーがユーザーのパスに含まれます。

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

      Copy to Clipboard Toggle word wrap

   5. rosa バージョンを照会して、ROSA CLI が正しくインストールされていることを確認します。

      $ rosa version

      Copy to Clipboard Toggle word wrap

      出力例

      1.2.47
      Your ROSA CLI is up to date.

      Copy to Clipboard Toggle word wrap

4. オフラインアクセストークンを使用して ROSA CLI にログインします。

   1. ログインコマンドを実行します。

      $ rosa login

      Copy to Clipboard Toggle word wrap

      出力例

      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:

      Copy to Clipboard Toggle word wrap

   2. コマンド出力にリストされている URL に移動して、オフラインアクセストークンを表示します。

   3. ログインするには、コマンドラインプロンプトでオフラインアクセストークンを入力します。

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

      Copy to Clipboard Toggle word wrap
      注記

      今後は、rosa login コマンドを実行するときに --token="<offline_access_token>" 引数を使用してオフラインアクセストークンを指定できます。

   4. 続行する前に、ログインしていることと認証情報が正しいことを確認してください。

      $ rosa whoami

      Copy to Clipboard Toggle word wrap

      出力例

      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>

      Copy to Clipboard Toggle word wrap

5. 最新の OpenShift CLI (oc) をインストールして設定します。

   1. ROSA CLI を使用して oc CLI をダウンロードします。

      次のコマンドは、CLI の最新バージョンを現在の作業ディレクトリーにダウンロードします。

      $ rosa download openshift-client

      Copy to Clipboard Toggle word wrap

   2. ダウンロードしたアーカイブから oc バイナリーファイルを展開します。次の例では、Linux tar アーカイブからファイルを展開します。

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

      Copy to Clipboard Toggle word wrap

   3. oc バイナリーを実行パス内のディレクトリーに移動します。以下の例では、/usr/local/bin ディレクトリーがユーザーのパスに含まれます。

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

      Copy to Clipboard Toggle word wrap

   4. oc CLI が正しくインストールされていることを確認します。

      $ rosa verify openshift-client

      Copy to Clipboard Toggle word wrap

      出力例

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

      Copy to Clipboard Toggle word wrap