第7章 ROSA CLI

手順

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

   1. AWS コマンドラインインターフェイス ドキュメントに従って、お使いのオペレーティングシステム用の AWS CLI をインストールし、設定します。

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

      注記

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

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

2. OpenShift Cluster Manager の Downloads ページから、お使いのオペレーティングシステムの ROSA CLI (rosa) の最新バージョンをダウンロードします。

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.15
   Your ROSA CLI is up to date.

   Copy to Clipboard Toggle word wrap

6. オプション: ROSA CLI のタブ補完を有効にします。タブ補完を有効にすると、Tab キーを 2 回押すことでサブコマンドが自動的に補完され、コマンドの提案が表示されます。

   • Linux ホストで Bash のタブ補完を永続的に有効にするには、以下を実行します。

     1. Bash 用の rosa タブ補完設定ファイルを生成し、/etc/bash_completion.d/ ディレクトリーに保存します。

        # rosa completion bash > /etc/bash_completion.d/rosa

        Copy to Clipboard Toggle word wrap
     2. 新しいターミナルを開き、設定を有効にします。

   • macOS ホストで Bash のタブ補完を永続的に有効にするには、以下を実行します。

     1. Bash 用の rosa タブ補完設定ファイルを生成し、/usr/local/etc/bash_completion.d/ ディレクトリーに保存します。

        $ rosa completion bash > /usr/local/etc/bash_completion.d/rosa

        Copy to Clipboard Toggle word wrap
     2. 新しいターミナルを開き、設定を有効にします。

   • Zsh ホストのタブ補完を永続的に有効にするには、以下を実行します。

     1. Zsh 環境でタブ補完が有効になっていない場合は、以下のコマンドを実行して有効にします。

        $ echo "autoload -U compinit; compinit" >> ~/.zshrc

        Copy to Clipboard Toggle word wrap

     2. Zsh の rosa タブ補完設定ファイルを生成し、関数パスの最初のディレクトリーに保存します。

        $ rosa completion zsh > "${fpath[1]}/_rosa"

        Copy to Clipboard Toggle word wrap
     3. 新しいターミナルを開き、設定を有効にします。

   • fish のタブ補完を永続的に有効にするには、以下を実行します。

     1. fish 用の rosa タブ補完設定ファイルを生成し、~/.config/fish/completions/ ディレクトリーに保存します。

        $ rosa completion fish > ~/.config/fish/completions/rosa.fish

        Copy to Clipboard Toggle word wrap
     2. 新しいターミナルを開き、設定を有効にします。

   • PowerShell のタブ補完を永続的に有効にするには、以下を実行します。

     1. PowerShell の rosa タブ補完設定ファイルを生成し、rosa.ps1 という名前のファイルに保存します。

        PS> rosa completion powershell | Out-String | Invoke-Expression

        Copy to Clipboard Toggle word wrap
     2. PowerShell プロファイルから rosa.ps1 ファイルを取得します。
   注記

   rosa タブ補完の設定に関する詳細は、rosa completion --help コマンドを実行してヘルプメニューを参照してください。

手順

1. Red Hat の OpenShift Cluster Manager オフライントークンを使用して rosa を初期化します。

   $ rosa init --token=<token>

   Copy to Clipboard Toggle word wrap

2. ROSA クラスターを作成します。

   $ rosa create cluster --cluster-name=<cluster_name>

   Copy to Clipboard Toggle word wrap

3. アイデンティティープロバイダー (IDP) を追加します。

   $ rosa create idp --cluster=<cluster_name> --type=<identity_provider> [arguments]

   Copy to Clipboard Toggle word wrap

4. dedicated-admin ユーザーを追加します。

   $ rosa grant user dedicated-admin --user=<idp_user_name> --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

手順

1. ROSA CLI (rosa) の新しいバージョンが利用可能であることを確認します。

   $ rosa version

   Copy to Clipboard Toggle word wrap

   出力例

   1.2.12
   There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

   Copy to Clipboard Toggle word wrap

2. ROSA CLI の互換性のある最新バージョンをダウンロードします。

   $ rosa download rosa

   Copy to Clipboard Toggle word wrap

   このコマンドは、rosa-*.tar.gz というアーカイブをカレントディレクトリーにダウンロードします。ファイルの正確な名前は、オペレーティングシステムとシステムアーキテクチャーによって異なります。

3. アーカイブの内容を展開します。

   $ tar -xzf rosa-linux.tar.gz

   Copy to Clipboard Toggle word wrap

4. 抽出したファイルをパスに移動して、新しいバージョンの ROSA CLI をインストールします。以下の例では、/usr/local/bin ディレクトリーがユーザーのパスに含まれます。

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

   Copy to Clipboard Toggle word wrap