1.2. 環境の設定
Red Hat OpenShift Service on AWS(ROSA) クラスターを作成する前に、以下のタスクを実行して環境を設定する必要があります。
- AWS および Red Hat アカウントに対して ROSA の前提条件を確認します。
- 必要なコマンドラインインターフェイス (CLI) ツールをインストールして設定する
- CLI ツールの設定を確認する
本セクションの手順に従って、これらの設定要件を完了できます。
ROSA の前提条件の確認
以下の手順に従って、AWS アカウントで Red Hat OpenShift Service on AWS (ROSA) を有効にします。
前提条件
- Red Hat アカウントを持っている。
AWS アカウントがある。
注記専用の AWS アカウントを使用して実稼働クラスターを実行することを検討してください。AWS Organizations を使用している場合は、組織内の AWS アカウントを使用するか、アカウントを新規作成 できます。
手順
- AWS 管理コンソール にログインします。
- ROSA service に移動します。
Get started をクリックします。
Verify ROSA prerequisites ページが開きます。
ROSA enablement の下で、緑色のチェックマークと
You previously enabled ROSA
が表示されていることを確認します。そうでない場合は、次の手順に従います。
-
I agree to share my contact information with Red Hat
の横にあるチェックボックスを選択します。 Enable ROSA をクリックします。
少し待つと、緑色のチェックマークと
You enabled ROSA
メッセージが表示されます。
-
Service Quotas の下に、緑色のチェックと
Your quotas meet the requirements for ROSA
が表示されていることを確認します。Your quotas don't meet the minimum requirements
が表示された場合は、エラーメッセージに表示されているクォータの種類と最小値をメモしてください。ガイダンスについては、割り当て増加のリクエスト に関する Amazon のドキュメントを参照してください。Amazon が割り当てリクエストを承認するまでに数時間かかる場合があります。-
ELB service-linked role の下で、緑色のチェックマークと
AWSServiceRoleForElasticLoadBalancing already exists
が表示されていることを確認します。 Continue to Red Hat をクリックします。
Get started with Red Hat OpenShift Service on AWS (ROSA) ページが新しいタブで開きます。このページのステップ 1 はすでに完了しており、ステップ 2 に進むことができます。
必要な CLI ツールのインストールと設定
次の手順を使用して、ワークステーションにインストールして設定します。
手順
最新の AWS CLI (
aws
) をインストールして設定します。AWS コマンドラインインターフェイス ドキュメントに従って、お使いのオペレーティングシステム用の AWS CLI をインストールし、設定します。
.aws/credentials
ファイルにaws_access_key_id
、aws_secret_access_key
、およびregion
を指定します。AWS ドキュメントの AWS 設定の基本 を参照してください。注記オプションで
AWS_DEFAULT_REGION
環境変数を使用して、デフォルトの AWS リージョンを設定できます。AWS API をクエリーし、AWS CLI が適切にインストールおよび設定されているかどうかを確認します。
$ aws sts get-caller-identity --output text
出力例
<aws_account_id> arn:aws:iam::<aws_account_id>:user/<username> <aws_user_id>
最新の ROSA CLI (
rosa
) をインストールし、設定します。- Red Hat OpenShift Cluster Manager Hybrid Cloud Console の ダウンロード ページから、オペレーティングシステム用の最新バージョンの ROSA CLI をダウンロードします。
ダウンロードしたアーカイブから
rosa
バイナリーファイルをデプロイメントします。以下の例は、Linux tar アーカイブからバイナリーをデプロイメントします。$ tar xvf rosa-linux.tar.gz
パスに
rosa
を加えてください。以下の例では、/usr/local/bin
ディレクトリーがユーザーのパスに含まれます。$ sudo mv rosa /usr/local/bin/rosa
rosa
バージョンをクエリーして、ROSA CLI ツールが適切にインストールされていることを確認します。$ rosa version
出力例
1.2.15 Your ROSA CLI is up to date.
ROSA CLI を使用して Red Hat アカウントにログインします。
$ rosa login
出力例
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:
コマンド出力にリスト表示されている URL に移動し、オフラインアクセストークンを取得します。ログインする CLI プロンプトでトークンを指定します。
注記その後に
rosa login
コマンドの実行時に--token="<offline_access_token>"
引数を使用してオフラインアクセストークンを指定できます。正常にログインできるかどうかを確認し、認証情報を確認します。
$ rosa whoami
出力例
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>
次に進む前に、出力の情報が正しいことを確認します。