Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

2.2. 環境の設定

Red Hat OpenShift Service on AWS(ROSA) クラスターを作成する前に、以下のタスクを実行して環境を設定する必要があります。

  • AWS および Red Hat アカウントに対して ROSA の前提条件を確認します。
  • 必要なコマンドラインインターフェイス (CLI) ツールをインストールして設定する
  • CLI ツールの設定を確認する

このセクションの手順に従って、これらの設定要件を完了できます。

2.2.1. ROSA の前提条件の確認

以下の手順に従って、AWS アカウントで Red Hat OpenShift Service on AWS (ROSA) を有効にします。

前提条件

  • Red Hat アカウントを持っている。

  • AWS アカウントがある。

    注記

    専用の AWS アカウントを使用して実稼働クラスターを実行することを検討してください。AWS Organizations を使用している場合は、組織内の 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 に進むことができます。

関連情報

2.2.2. 必要な CLI ツールのインストールと設定

クラスターをデプロイして操作するには、コマンドラインインターフェイス (CLI) ツールが複数必要です。

前提条件

  • AWS アカウントがある。
  • Red Hat アカウントを持っている。

手順

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

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

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

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

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

      注記

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

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

  1. 最新の ROSA CLI (rosa) をインストールし、設定します。

    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

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

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

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

      $ rosa version

      出力例

      1.2.47
Your ROSA CLI is up to date.

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

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

      $ 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:

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

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

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

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

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

      $ 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>

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

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

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

      $ rosa download openshift-client

    2. ダウンロードしたアーカイブから oc バイナリーファイルをデプロイメントします。以下の例は、Linux tar アーカイブからファイルをデプロイメントします。 

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

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

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

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

      $ rosa verify openshift-client

      出力例

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.