7.2. ROSA CLI を使用したオブジェクトの管理
dedicated-admin ユーザーの追加、クラスターの管理、クラスターのアップグレードのスケジューリング設定など、ROSA コマンドラインインターフェイス (CLI) (rosa) を使用してオブジェクトを管理します。
HTTP プロキシーサーバー上でのみアクセスできるクラスターにアクセスするには、HTTP_PROXY、HTTPS_PROXY、および NO_PROXY 変数を設定できます。これらの環境変数は、クラスターとのすべての通信が HTTP プロキシーを経由するように rosa CLI で使用されます。
7.2.1. 一般的なコマンドおよび引数 リンクのコピーリンクがクリップボードにコピーされました!
これらの一般的なコマンドと引数は、ROSA コマンドラインインターフェイス (CLI) (rosa) で使用できます。
7.2.1.1. debug リンクのコピーリンクがクリップボードにコピーされました!
トラブルシューティングに役立つように、親コマンドのデバッグモードを有効にします。
例
rosa create cluster --cluster-name=<cluster_name> --debug
$ rosa create cluster --cluster-name=<cluster_name> --debug
7.2.1.2. download リンクのコピーリンクがクリップボードにコピーされました!
指定されたソフトウェアの互換性のある最新バージョンをアーカイブファイル形式でカレントディレクトリーにダウンロードします。ソフトウェアを使用するには、アーカイブの内容を抽出し、その内容をパスに追加します。最新の ROSA CLI をダウンロードするには、rosa を指定します。最新の OpenShift CLI をダウンロードするには、oc を指定します。
例
rosa download <software>
$ rosa download <software>
7.2.1.3. help リンクのコピーリンクがクリップボードにコピーされました!
ROSA CLI (rosa) の一般的なヘルプ情報および利用可能なコマンドの一覧を表示します。このオプションは、version、create などの親コマンドのヘルプ情報を表示する引数として使用することもできます。
例
ROSA CLI の一般的なヘルプを表示します。
rosa --help
$ rosa --help
version の一般的なヘルプを表示します。
rosa version --help
$ rosa version --help
7.2.1.4. interactive リンクのコピーリンクがクリップボードにコピーされました!
対話モードを有効にします。
例
rosa create cluster --cluster-name=<cluster_name> --interactive
$ rosa create cluster --cluster-name=<cluster_name> --interactive
7.2.1.5. profile リンクのコピーリンクがクリップボードにコピーされました!
認証情報ファイルから AWS プロファイルを指定します。
例
rosa create cluster --cluster-name=<cluster_name> --profile=myAWSprofile
$ rosa create cluster --cluster-name=<cluster_name> --profile=myAWSprofile
7.2.1.6. version リンクのコピーリンクがクリップボードにコピーされました!
rosa のバージョンを表示し、新しいバージョンが利用可能かどうかを確認します。
例
rosa version [arguments]
$ rosa version [arguments]
出力例
新しいバージョンの ROSA CLI が利用可能な場合に表示されます。
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/
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/
7.2.2. 親コマンド リンクのコピーリンクがクリップボードにコピーされました!
ROSA コマンドラインインターフェイス (CLI) (rosa) は、親コマンドと子コマンドを使用してオブジェクトを管理します。親コマンドは、create、edit、delete、list、および describe です。すべての親コマンドをすべての子コマンドと共に使用できる訳ではありません。詳細は、子コマンドを説明する特定の参照トピックを参照してください。
7.2.2.1. create リンクのコピーリンクがクリップボードにコピーされました!
子コマンドとペアとなった場合に、オブジェクトまたはリソースを作成します。
例
rosa create cluster --cluster-name=mycluster
$ rosa create cluster --cluster-name=mycluster
7.2.2.2. edit リンクのコピーリンクがクリップボードにコピーされました!
クラスタープライベートの作成など、オブジェクトのオプションを編集します。
例
rosa edit cluster --cluster=mycluster --private
$ rosa edit cluster --cluster=mycluster --private
7.2.2.3. delete リンクのコピーリンクがクリップボードにコピーされました!
子コマンドとペアとなった場合に、オブジェクトまたはリソースを削除します。
例
rosa delete ingress --cluster=mycluster
$ rosa delete ingress --cluster=mycluster
7.2.2.4. list リンクのコピーリンクがクリップボードにコピーされました!
特定のクラスター向けにクラスターまたはリソースをリスト表示します。
例
rosa list users --cluster=mycluster
$ rosa list users --cluster=mycluster
7.2.2.5. describe リンクのコピーリンクがクリップボードにコピーされました!
クラスターの詳細を表示します。
例
rosa describe cluster --cluster=mycluster
$ rosa describe cluster --cluster=mycluster
7.2.3. オブジェクトの作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Service on AWS クラスターを作成するには、必要に応じて '--hosted-cp' フラグを含めてください。
このセクションでは、クラスターおよびリソース向けの create コマンドを説明します。
7.2.3.1. account-roles の作成 リンクのコピーリンクがクリップボードにコピーされました!
クラスターに必要なアカウント全体のロールとポリシーリソースを作成します。
構文
rosa create account-roles [flags]
$ rosa create account-roles [flags]
| オプション | 定義 |
|---|---|
| --debug | デバッグモードを有効化します |
| -i, --interactive | 対話モードを有効にします。 |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --path 文字列 | Operator ポリシーを含む、アカウント全体のロールとポリシーの Amazon Resource Name (ARN) パス。 |
| --permissions-boundary 文字列 | アカウントロールのアクセス許可の境界を設定するために使用されるポリシーの ARN。 |
| --prefix 文字列 |
生成されたすべての AWS リソースのユーザー定義の接頭辞。デフォルトは |
| --profile 文字列 | 認証情報ファイルから特定の AWS プロファイルを使用します。 |
| -y, --yes | 自動的に Yes と回答して操作を確定します。 |
7.2.3.2. create admin リンクのコピーリンクがクリップボードにコピーされました!
クラスターへのログインが可能な自動生成されたパスワードが設定されたクラスター管理者を作成します。
構文
rosa create admin --cluster=<cluster_name>|<cluster_id>
$ rosa create admin --cluster=<cluster_name>|<cluster_id>
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須。アイデンティティープロバイダー (IDP) に追加するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile 文字列 | 認証情報ファイルから AWS プロファイルを指定します。 |
例
mycluster という名前のクラスターにログインできるクラスター管理者を作成します。
rosa create admin --cluster=mycluster
$ rosa create admin --cluster=mycluster
7.2.3.3. ブレークグラス認証情報の作成 リンクのコピーリンクがクリップボードにコピーされました!
外部認証が有効な Red Hat OpenShift Service on AWS クラスターのブレークグラス認証情報を作成します。
構文
rosa create break-glass-credential --cluster=<cluster_name> [arguments]
$ rosa create break-glass-credential --cluster=<cluster_name> [arguments]
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須。ブレークグラス認証情報を追加するクラスターの名前または ID。 |
| --expiration | オプション: ブレークグラス認証情報が期限切れになるまでに使用できる期間。有効期限は、最小 10 分、最大 24 時間にする必要があります。値を入力しない場合、有効期限はデフォルトで 24 時間になります。 |
| --username | オプション: ブレークグラス認証情報のユーザー名。値を入力しない場合は、ランダムなユーザー名が生成されます。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
| --region |
|
| --yes |
操作を確認するために、自動的に |
例
mycluster という名前のクラスターにブレークグラス認証情報を追加します。
構文
rosa create break-glass-credential --cluster=mycluster
$ rosa create break-glass-credential --cluster=mycluster
インタラクティブモードを使用して、mycluster という名前のクラスターにブレークグラス認証情報を追加します。
構文
rosa create break-glass-credential --cluster=mycluster -i
$ rosa create break-glass-credential --cluster=mycluster -i
7.2.3.4. create cluster リンクのコピーリンクがクリップボードにコピーされました!
新規クラスターを作成します。
構文
rosa create cluster --cluster-name=<cluster_name> [arguments]
$ rosa create cluster --cluster-name=<cluster_name> [arguments]
| オプション | 定義 |
|---|---|
| --additional-compute-security-group-ids <sec_group_id> | クラスターと一緒に作成される標準マシンプール用のデフォルトセキュリティーグループとともに使用する、1 つ以上の追加セキュリティーグループの識別子。追加セキュリティーグループの詳細は、関連情報 の セキュリティーグループ の要件を参照してください。 |
| --additional-infra-security-group-ids <sec_group_id> | クラスターと一緒に作成されるインフラノード用のデフォルトセキュリティーグループとともに使用する、1 つ以上の追加セキュリティーグループの識別子。追加セキュリティーグループの詳細は、関連情報 の セキュリティーグループ の要件を参照してください。 |
| --additional-control-plane-security-group-ids <sec_group_id> | クラスターと一緒に作成されるコントロールプレーンノード用のデフォルトセキュリティーグループとともに使用する、1 つ以上の追加セキュリティーグループの識別子。追加セキュリティーグループの詳細は、関連情報 の セキュリティーグループ の要件を参照してください。 |
| --additional-allowed-principals <arn> | 追加の VPC エンドポイント接続要求の自動受け入れを可能にするために Hosted Control Plane の VPC エンドポイントサービスに追加される、追加の許可済みプリンシパル ARN のコンマ区切りリスト。 |
| --cluster-name <cluster_name> |
必須。クラスターの名前。 |
| --compute-machine-type <instance_type> | クラスター内のコンピュートノードのインスタンスタイプ。これは、各コンピュートノードに割り当てられるメモリーおよび仮想 CPU の容量を決定します。有効なインスタンスタイプの詳細は、ROSA サービス定義 の AWS インスタンスタイプ を参照してください。 |
| --controlplane-iam-role <arn> | コントロールプレーンインスタンスにアタッチする IAM ロールの ARN。 |
| --create-cluster-admin |
オプション: クラスター作成の一環として、クラスターのローカル管理者ユーザー ( |
| --cluster-admin-user |
オプション: |
| --cluster-admin-password |
オプション: |
| --disable-scp-checks | クラスターのインストールの試行時に、クラウドパーミッションチェックが無効になるかどうかを示します。 |
| --dry-run | クラスターの作成をシミュレーションします。 |
| --domain-prefix |
オプション: |
| --ec2-metadata-http-tokens string |
EC2 インスタンスに対する IMDSv2 の使用を設定します。有効な値は、 |
| --enable-autoscaling |
コンピュートノードの自動スケーリングを有効にします。デフォルトでは、自動スケーリングは |
| --etcd-encryption | Red Hat OpenShift Service on AWS (クラシックアーキテクチャー) クラスターで ETCD キー値の暗号化を有効にします。 |
| --etcd-encryption-kms-arn | AWS Key Management Service で管理される顧客管理の鍵を使用して、ETCD ストレージの暗号化を有効にします。 |
| --external-id <arn_string> | 別のアカウントでロールを引き受けるときに必要になる可能性があるオプションの一意の識別子。 |
| --host-prefix <subnet> |
個々のノードに割り当てるサブネット接頭辞の長さを整数で指定します。たとえば、ホスト接頭辞が |
| --machine-cidr <address_block> |
クラスターのインストール中に Red Hat OpenShift Service on AWS によって使用される IP アドレスのブロック (ipNet) (例: 重要
Red Hat OpenShift Service on AWS 4.11 以降のデフォルトのネットワークプロバイダーである OVN-Kubernetes は、IP アドレス範囲 |
| --max-replicas <number_of_nodes> |
自動スケーリングを有効にする際のコンピュートノードの最大数を指定します。デフォルトは、 |
| --min-replicas <number_of_nodes> |
自動スケーリングを有効にする際のコンピュートノードの最小数を指定します。デフォルトは、 |
| --no-cni | Container Network Interface (CNI) プラグインなしでクラスターを作成します。クラスターの作成後、お客様は独自の CNI プラグインを用意してインストールできます。 |
| --operator-roles-prefix <string> | OpenShift インストーラーで必要な Operator によって使用されるすべての IAM ロールに使用する接頭辞。接頭辞を指定しない場合は、接頭辞が自動的に生成されます。 |
| --pod-cidr <address_block> |
Pod IP アドレスの割り当てに使用する IP アドレス (ipNet) のブロックです (例: 重要
Red Hat OpenShift Service on AWS 4.11 以降のデフォルトのネットワークプロバイダーである OVN-Kubernetes は、IP アドレス範囲 |
| --private | プライマリー API エンドポイントおよびアプリケーションルートを直接かつプライベートの接続に制限します。 |
| --region <region_name> |
ワーカープールが配置される AWS リージョンの名前 (例: |
| --replicas n |
アベイラビリティーゾーンごとにプロビジョニングするワーカーノードの数。シングルゾーンクラスターには、2 つ以上のノードが必要です。マルチゾーンクラスターには、3 つ以上のノードが必要です。デフォルト: シングルゾーンクラスターの場合は |
| --role-arn <arn> | OpenShift Cluster Manager がクラスターの作成に使用するインストーラーロールの ARN。これは、アカウントのロールをまだ作成していない場合に必要です。 |
| --service-cidr <address_block> |
サービス用の IP アドレス (ipNet) のブロック (例: 重要
ROSA 4.11 以降のデフォルトのネットワークプロバイダーである OVN-Kubernetes は、IP アドレス範囲 |
| --sts | クラスターをデプロイするために AWS Security Token Service (STS) 認証情報を使用することを指定します。 |
| --subnet-ids <aws_subnet_id> |
クラスターのインストール時に使用する AWS サブネット ID (例:
"プライベート API" のために |
| --support-role-arn 文字列 | Red Hat Site Reliability Engineer (SRE) がクラスターアカウントへのアクセスを有効にしてサポートを提供するために使用するロールの ARN。 |
| --tags | Red Hat OpenShift Service on AWS によって作成された AWS 内のリソースで使用されるタグ。タグは、AWS 内のリソースの管理、識別、整理、検索、フィルタリングに使用できます。タグはコンマで区切られます (例: "key value、foo bar")。 重要 Red Hat OpenShift Service on AWS は、クラスター作成時に Red Hat OpenShift リソースへのカスタムタグのみをサポートします。タグを追加すると、削除したり編集したりすることはできません。Red Hat が追加したタグは、クラスターが Red Hat の実稼働サービスレベルアグリーメント (SLA) への準拠を維持するために必要です。これらのタグは削除してはいけません。 Red Hat OpenShift Service on AWS では、Red Hat OpenShift Service on AWS クラスターによって管理されるリソース以外へのタグの追加はサポートされていません。AWS リソースが ROSA クラスターによって管理されている場合、これらのタグが失われる可能性があります。このような場合、タグを調整してそのままの状態に保つためのカスタムソリューションまたはツールが必要になる可能性があります。 |
| --version 文字列 |
クラスターまたはクラスターリソースのインストールに使用される Red Hat OpenShift Service on AWS のバージョン。 |
| --worker-iam-role 文字列 | コンピューティングインスタンスにアタッチされる IAM ロールの ARN。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
mycluster という名前のクラスターを作成します。
rosa create cluster --cluster-name=mycluster
$ rosa create cluster --cluster-name=mycluster
特定の AWS リージョンでクラスターを作成します。
rosa create cluster --cluster-name=mycluster --region=us-east-2
$ rosa create cluster --cluster-name=mycluster --region=us-east-2
デフォルトのワーカーマシンプールで自動スケーリングを有効にして、クラスターを作成します。
rosa create cluster --cluster-name=mycluster -region=us-east-1 --enable-autoscaling --min-replicas=2 --max-replicas=5
$ rosa create cluster --cluster-name=mycluster -region=us-east-1 --enable-autoscaling --min-replicas=2 --max-replicas=5
7.2.3.5. external-auth-provider の作成 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift OAuth2 サーバーの代わりに外部アイデンティティープロバイダーを追加します。
構文
rosa create external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa create external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --claim-mapping-groups-claim <string> | 必須。ID トークンからの情報をクラスターアイデンティティーに変換する方法に関するルールを説明します。 |
| --claim-validation-rule <strings> |
ユーザーを認証するためにトークン要求を検証するために適用されるルール。入力は |
| --claim-mapping-username-claim <string> | クラスターアイデンティティーのユーザー名を構築するために使用されるクレームの名前。 |
| --cluster <cluster_name>|<cluster_id> | 必須。IDP が追加されるクラスターの名前または ID。 |
| --console-client-id <string> | OpenShift Cluster Manager Web コンソールの OIDC プロバイダーからの OIDC クライアントの識別子。 |
| --console-client-secret <string> | コンソールアプリケーションの登録に関連付けられているシークレット。 |
| --issuer-audiences <strings> | 受信トークンをチェックするオーディエンスの配列。有効なトークンには、オーディエンス要求にこれらの値の少なくとも 1 つが含まれている必要があります。 |
| --issuer-ca-file <string> | サーバーにリクエストを行うときに使用する PEM エンコードされた証明書ファイルへのパス。 |
| --issuer-url <string> | トークン発行者のサービス URL。 |
| --name <string> | 外部認証プロバイダーを参照するために使用される名前。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル文字列を指定します。 |
例
mycluster という名前のクラスターに Microsoft Entra ID アイデンティティープロバイダーを追加します。
rosa create external-auth-provider --cluster=mycluster --name <provider_name> --issuer-audiences <audience_id> --issuer-url <issuing id> --claim-mapping-username-claim email --claim-mapping-groups-claim groups
$ rosa create external-auth-provider --cluster=mycluster --name <provider_name> --issuer-audiences <audience_id> --issuer-url <issuing id> --claim-mapping-username-claim email --claim-mapping-groups-claim groups
7.2.3.6. create idp リンクのコピーリンクがクリップボードにコピーされました!
アイデンティティープロバイダー (IDP) を追加して、ユーザーのクラスターへのログイン方法を定義します。
構文
rosa create idp --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa create idp --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須。IDP が追加されるクラスターの名前または ID。 |
| --ca <path_to_file> |
サーバーにリクエストを行うときに使用する PEM エンコードされた証明書ファイルへのパス ( |
| --client-id | 登録されたアプリケーションのクライアント ID (文字列)。 |
| --client-secret | 登録したアプリケーションのクライアントシークレット (文字列)。 |
| --mapping-method |
新規アイデンティティー (文字列) がログイン時にユーザーにマップされる方法を指定します。デフォルトは、 |
| --name | アイデンティティープロバイダーの名前 (文字列)。 |
| --type |
アイデンティティープロバイダーのタイプ (文字列)。オプションは、 |
| オプション | 定義 |
|---|---|
| --hostname | GitHub Enterprise のホストされたインスタンスで使用するオプションのドメイン (文字列)。 |
| --organizations | ログインアクセス用の組織を指定します。リスト表示されている組織 (文字列) のうち、1 つ以上の組織のメンバーであるユーザーのみがログインできます。 |
| --teams |
ログインアクセスのためのチームを指定します。リスト表示されているチーム (文字列) のうち、1 つ以上のチームのメンバーであるユーザーのみがログインできます。形式は |
| オプション | 定義 |
|---|---|
| --host-url |
GitLab プロバイダーのホスト URL (文字列)。デフォルトは、 |
| オプション | 定義 |
|---|---|
| --hosted-domain | ユーザーを Google Apps ドメイン (文字列) に制限します。 |
| オプション | 定義 |
|---|---|
| --bind-dn | 検索フェーズでバインドするドメイン名 (文字列) です。 |
| --bind-password | 検索フェーズでバインドするパスワード (文字列) です。 |
| --email-attributes | メールアドレスとして使用する必要がある値を持つ属性のリスト (文字列) です。 |
| --id-attributes |
ユーザー ID として使用する必要がある値を持つ属性のリスト (文字列) です。デフォルトは、 |
| --insecure | サーバーへの TLS 接続を実行しません。 |
| --name-attributes |
表示名として使用する必要がある値を持つ属性のリスト (文字列) です。デフォルトは、 |
| --url | 使用する LDAP 検索パラメーターを指定する RFC 2255 URL (文字列) です。 |
| --username-attributes |
優先ユーザー名として使用する必要がある値を持つ属性のリスト (文字列) です。デフォルトは、 |
| オプション | 定義 |
|---|---|
| --email-claims | メールアドレスとして使用するクレームのリスト (文字列) です。 |
| --extra-scopes |
認可トークン要求時に |
| --issuer-url | OpenID プロバイダーが発行者 ID としてアサートする URL (文字列)。URL クエリーパラメーターまたはフラグメントのない HTTPS スキームを使用する必要があります。 |
| --name-claims | 表示名として使用するクレームのリスト (文字列) です。 |
| --username-claims | ユーザーをプロビジョニングするときに優先ユーザー名として使用するクレームのリスト (文字列) です。 |
| --groups-claims | グループ名として使用するクレームのリスト (文字列) です。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
GitHub アイデンティティープロバイダーを mycluster という名前のクラスターに追加します。
rosa create idp --type=github --cluster=mycluster
$ rosa create idp --type=github --cluster=mycluster
インタラクティブなプロンプトに従って、アイデンティティープロバイダーを追加します。
rosa create idp --cluster=mycluster --interactive
$ rosa create idp --cluster=mycluster --interactive
7.2.3.7. イメージミラー設定の作成 リンクのコピーリンクがクリップボードにコピーされました!
イメージミラー設定機能は、ダイジェストによるイメージ参照でのみ動作します。つまり、イメージミラーリングが有効になるのは、一意かつイミュータブルな ID を使用してイメージがプルされた場合だけです。ミュータブルなタグを使用するイメージ参照は、現在この機能ではサポートされていません。
イメージミラー設定を作成するには、Red Hat OpenShift Service on AWS クラスターが Ready 状態になっている必要があります。
クラスターのイメージミラー設定を作成します。
構文
rosa create image-mirror [arguments]
$ rosa create image-mirror [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: ミラー設定を適用するクラスターの名前または ID。 |
| --source | 必須: ミラーリングされるソースレジストリー。 |
| --mirrors | 必須: ミラーレジストリーのリスト。ミラーレジストリーはコンマで区切る必要があります。 |
| --type=digest |
任意: イメージミラーのタイプ。 |
| --profile | 任意: 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
| --region | 任意: AWS リージョンを指定し、AWS_REGION 環境変数をオーバーライドします。 |
例
mycluster という名前のクラスターにイメージミラー設定を追加します。
ソースレジストリーは作成後に変更することはできません。ソースを変更するには、イメージミラーを削除して再作成する必要があります。
rosa create image-mirror --cluster=mycluster \ --source=registry.example.com/team \ --mirrors=mirror.corp.com/team,backup.corp.com/team
$ rosa create image-mirror --cluster=mycluster \
--source=registry.example.com/team \
--mirrors=mirror.corp.com/team,backup.corp.com/team
特定のタイプのイメージミラー設定をクラスターに追加します。
rosa create image-mirror --cluster=mycluster \ --type=digest --source=docker.io/library \ --mirrors=internal-registry.company.com/dockerhub
$ rosa create image-mirror --cluster=mycluster \
--type=digest --source=docker.io/library \
--mirrors=internal-registry.company.com/dockerhub
クラスターに複数のミラーイメージ設定を追加します。
rosa create image-mirror --cluster=mycluster \ --source=quay.io/openshift \ --mirrors=mirror1.company.com/openshift,mirror2.company.com/openshift,mirror3.company.com/openshift
$ rosa create image-mirror --cluster=mycluster \
--source=quay.io/openshift \
--mirrors=mirror1.company.com/openshift,mirror2.company.com/openshift,mirror3.company.com/openshift
7.2.3.8. create ingress リンクのコピーリンクがクリップボードにコピーされました!
Ingress エンドポイントを追加して、クラスターへの API アクセスを有効にします。
構文
rosa create ingress --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa create ingress --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須: Ingress が追加されるクラスターの名前または ID。 |
| --label-match | Ingress のラベル一致 (文字列)。形式は、キーと値のペアのコンマ区切りリストにする必要があります。ラベルが指定されていない場合は、すべてのルートが両方のルーターで公開されます。 |
| --private | アプリケーションルートを直接かつプライベートの接続に制限します。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
mycluster という名前のクラスターに内部イングレスを追加します。
rosa create ingress --private --cluster=mycluster
$ rosa create ingress --private --cluster=mycluster
mycluster という名前のクラスターにパブリックイングレスを追加します。
rosa create ingress --cluster=mycluster
$ rosa create ingress --cluster=mycluster
ルートセレクターラベルが一致するイングレスを追加します。
rosa create ingress --cluster=mycluster --label-match=foo=bar,bar=baz
$ rosa create ingress --cluster=mycluster --label-match=foo=bar,bar=baz
7.2.3.9. create kubeletconfig リンクのコピーリンクがクリップボードにコピーされました!
マシンプール内のノードのカスタム設定を可能にするために、カスタム KubeletConfig オブジェクトを作成します。
構文
rosa create kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]
$ rosa create kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]
| オプション | 定義 |
|---|---|
| --pod-pids-limit <number> | 必須。各ノードの PID の最大数。 |
| -c, --cluster <cluster_name>|<cluster_id> |
必須。 |
| --name |
|
| -i, --interactive | 対話モードを有効にします。 |
| -h, --help | このコマンドのヘルプを表示します。 |
クラスターの PID 制限の設定の詳細は、PID 制限の設定 を参照してください。
7.2.3.10. create machinepool リンクのコピーリンクがクリップボードにコピーされました!
マシンプールを既存クラスターに追加します。
マシンプールは、Red Hat OpenShift Service on AWS クラスターではノードプールとも呼ばれます。
構文
rosa create machinepool --cluster=<cluster_name> | <cluster_id> --replicas=<number> --name=<machinepool_name> [arguments]
$ rosa create machinepool --cluster=<cluster_name> | <cluster_id> --replicas=<number> --name=<machinepool_name> [arguments]
| オプション | 定義 |
|---|---|
| --additional-security-group-ids <sec_group_id> | このマシンプールのデフォルトセキュリティーグループとともに使用する、1 つ以上の追加セキュリティーグループの識別子。追加セキュリティーグループの詳細は、関連情報 の セキュリティーグループ の要件を参照してください。 |
| --cluster <cluster_name>|<cluster_id> | 必須: マシンプールを追加するクラスターの名前または ID。 |
| --disk-size | マシンプールのディスクボリュームサイズを Gib または TiB で設定します。デフォルトは 300 GiB です。Red Hat OpenShift Service on AWS クラスターの場合、最小ディスクサイズは 75 GiB、最大ディスクサイズは 16,384 GiB です。 |
| --enable-autoscaling |
コンピュートノードの自動スケーリングを有効または無効にします。自動スケーリングを有効にするには、 |
| --instance-type |
使用する必要のあるインスタンスタイプ (文字列)。デフォルトは、 |
| --kubelet-configs <kubeletconfig_name> |
マシンプール内のノードに適用する |
| --labels | マシンプールのラベル (文字列)。形式は、キーと値のペアのコンマ区切りリストにする必要があります。このリストは、継続的にノードラベルに加えられるすべての変更を上書きします。 |
| --max-replicas | 自動スケーリングを有効にする際のコンピュートノードの最大数を指定します。 |
| --min-replicas | 自動スケーリングを有効にする際のコンピュートノードの最小数を指定します。 |
| --max-surge |
デフォルト値は |
| --max-unavailable |
デフォルト値は |
| --name | 必須: マシンプールの名前 (文字列)。 |
| --replicas | 自動スケーリングが設定されていない場合に必要です。このマシンプールのマシンの数 (整数)。 |
| --tags |
Red Hat OpenShift Service on AWS によって作成された AWS 内のすべてのリソースに、ユーザー定義のタグを適用します。タグはコンマで区切られます (例: |
| --taints |
マシンプールのテイント。この文字列値は、 |
| --autorepair |
マシンプールの AutoRepair 設定。ブール値の |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
mycluster という名前のクラスターにマシンプールをインタラクティブに追加します。
rosa create machinepool --cluster=mycluster --interactive
$ rosa create machinepool --cluster=mycluster --interactive
自動スケーリングが有効になっているクラスターに、mp-1 という名前のマシンプールを追加します。
rosa create machinepool --cluster=mycluster --enable-autoscaling --min-replicas=2 --max-replicas=5 --name=mp-1
$ rosa create machinepool --cluster=mycluster --enable-autoscaling --min-replicas=2 --max-replicas=5 --name=mp-1
m5.xlarge の 3 つのレプリカを含む mp-1 という名前のマシンプールをクラスターに追加します。
rosa create machinepool --cluster=mycluster --replicas=3 --instance-type=m5.xlarge --name=mp-1
$ rosa create machinepool --cluster=mycluster --replicas=3 --instance-type=m5.xlarge --name=mp-1
Red Hat OpenShift Service on AWS クラスターにマシンプール (mp-1) を追加し、6 つのレプリカと次のアップグレード動作を設定します。
- アップグレード中に最大 2 つの余分なノードをプロビジョニングできるようにします。
- アップグレード中に使用できないノードが 3 つ以下であることを確認します。
rosa create machinepool --cluster=mycluster --replicas=6 --name=mp-1 --max-surge=2 --max-unavailable=3
$ rosa create machinepool --cluster=mycluster --replicas=6 --name=mp-1 --max-surge=2 --max-unavailable=3
ラベル付きのマシンプールをクラスターに追加します。
rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --labels=foo=bar,bar=baz --name=mp-1
$ rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --labels=foo=bar,bar=baz --name=mp-1
タグ付きのマシンプールをクラスターに追加します。
rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --tags='foo bar,bar baz' --name=mp-1
$ rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --tags='foo bar,bar baz' --name=mp-1
7.2.3.11. create network リンクのコピーリンクがクリップボードにコピーされました!
AWS CloudFormation テンプレートを通じて、必要な AWS リソースを作成するネットワークを作成します。このヘルパーコマンドは、Red Hat OpenShift Service on AWS で使用する VPC の作成と設定を支援することを目的としています。このコマンドは、Egress ゼロのクラスターもサポートしています。
このコマンドを実行すると、AWS アカウント内にリソースが作成されます。
カスタム設定または詳細設定を指定する場合は、aws cloudformation コマンドを使用して AWS CLI を直接使用するか、必要な設定を含む新しいカスタムテンプレートを作成することを強く推奨します。ROSA CLI でカスタム CloudFormation テンプレートを使用する場合、必要な最小バージョンは 1.2.47 以降です。
構文
rosa create network [flags]
$ rosa create network [flags]
| オプション | 定義 |
|---|---|
| <template-name> |
カスタムテンプレートを使用できます。テンプレートは、 |
デフォルトの CloudFormation テンプレート
| オプション | 定義 |
|---|---|
| --template-dir |
テンプレートディレクトリーへのパスを指定できます。 |
| --param Name | ネットワークの名前を定義します。カスタムテンプレートファイルを使用する場合は必須パラメーターです。 |
| --param Region | ネットワークのリージョンを定義します。カスタムテンプレートファイルを使用する場合は必須パラメーターです。 |
| --param <various> |
使用可能なパラメーターはテンプレートによって異なります。使用可能なパラメーターを見つけるには、テンプレートディレクトリー内で |
| --mode=manual | ネットワークスタックを作成するための AWS コマンドを提供します。 |
例
通常の引数とフラグを使用して基本的なネットワークを作成します。
rosa create network rosa-quickstart-default-vpc --param Tags=key1=value1,key2=value2 --param Name=example-stack --param Region=us-west-2
$ rosa create network rosa-quickstart-default-vpc --param Tags=key1=value1,key2=value2 --param Name=example-stack --param Region=us-west-2
デフォルトのテンプレートでパラメーターの全リストを確認できます。
テンプレートの例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow == ocm-role の作成
クラスターに必要な ocm-role リソースを作成します。
構文
rosa create ocm-role [flags]
$ rosa create ocm-role [flags]
| オプション | 定義 |
|---|---|
| --admin | ロールの管理機能を有効にします。 |
| --debug | デバッグモードを有効化します |
| -i, --interactive | 対話モードを有効にします。 |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --path 文字列 | OCM ロールとポリシーの ARN パス。 |
| --permissions-boundary 文字列 | OCM ロールのアクセス許可の境界を設定するために使用されるポリシーの ARN。 |
| --prefix 文字列 |
生成されたすべての AWS リソースのユーザー定義の接頭辞。デフォルトは |
| --profile 文字列 | 認証情報ファイルから特定の AWS プロファイルを使用します。 |
| -y, --yes | 自動的に Yes と回答して操作を確定します。 |
rosa create ocm-role コマンドで作成された OCM ロールの詳細には、アカウント全体の IAM ロールとポリシー参照 を参照してください。
7.2.3.12. user-role の作成 リンクのコピーリンクがクリップボードにコピーされました!
クラスターに必要なユーザーロールリソースを作成します。
構文
rosa create user-role [flags]
$ rosa create user-role [flags]
| オプション | 定義 |
|---|---|
| --debug | デバッグモードを有効化します |
| -i, --interactive | 対話モードを有効にします。 |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --path 文字列 | ユーザーロールとポリシーの ARN パス。 |
| --permissions-boundary 文字列 | ユーザーロールのアクセス許可の境界を設定するために使用されるポリシーの ARN。 |
| --prefix 文字列 |
生成されたすべての AWS リソースのユーザー定義の接頭辞。デフォルトは |
| --profile 文字列 | 認証情報ファイルから特定の AWS プロファイルを使用します。 |
| -y, --yes | 自動的に Yes と回答して操作を確定します。 |
rosa create user-role コマンドで作成されたユーザーロールの詳細は、AWS アカウントの関連付けについて を参照してください。
7.2.3.13. iamserviceaccount の作成 リンクのコピーリンクがクリップボードにコピーされました!
OpenID Connect (OIDC) アイデンティティーフェデレーションを使用して、Red Hat OpenShift Service on AWS サービスアカウントが引き受けることができる AWS Identity and Access Management (IAM) ロールを作成します。
構文
rosa create iamserviceaccount --cluster=<cluster_name> | <cluster_id> --name=<service_account_name> [arguments]
$ rosa create iamserviceaccount --cluster=<cluster_name> | <cluster_id> --name=<service_account_name> [arguments]
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須。IAM サービスアカウントロールを作成するクラスターの名前または ID。 |
| --name <service_account_name> | 必須。Red Hat OpenShift Service on AWS サービスアカウントの名前。このフラグを複数回使用すると、複数のサービスアカウント用のロールを作成できます。 |
| --namespace <namespace_name> |
サービスアカウントの Red Hat OpenShift Service on AWS namespace。デフォルト: |
| --role-name <role_name> |
作成する IAM ロールの名前。指定しない場合は、 |
| --attach-policy-arn <policy_arn> | ロールにアタッチする IAM ポリシーの ARN。このフラグを複数回使用すると、複数のポリシーをアタッチできます。 |
| --inline-policy <policy_document> |
JSON 形式のインラインポリシードキュメント、または |
| --permissions-boundary <boundary_arn> | ロールのアクセス許可の境界として使用する IAM ポリシーの ARN。 |
| --path <iam_path> |
ロールの IAM パス。デフォルト: |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile 文字列 | 認証情報ファイルから AWS プロファイルを指定します。 |
| --yes |
操作を確認するために、自動的に |
例
default namespace の my-app という名前のサービスアカウントに、S3 読み取り専用アクセス権を持つ IAM ロールを作成します。
rosa create iamserviceaccount --cluster=mycluster --name=my-app --attach-policy-arn=arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess
$ rosa create iamserviceaccount --cluster=mycluster --name=my-app --attach-policy-arn=arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess
カスタム名と複数のポリシーを持つ IAM ロールを作成します。
rosa create iamserviceaccount --cluster=mycluster --name=my-app --namespace=production --role-name=my-custom-role --attach-policy-arn=arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess --attach-policy-arn=arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess
$ rosa create iamserviceaccount --cluster=mycluster --name=my-app --namespace=production --role-name=my-custom-role --attach-policy-arn=arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess --attach-policy-arn=arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess
ファイルのインラインポリシー使用して IAM ロールを作成します。
rosa create iamserviceaccount --cluster=mycluster --name=my-app --inline-policy=file://my-policy.json
$ rosa create iamserviceaccount --cluster=mycluster --name=my-app --inline-policy=file://my-policy.json
7.2.4. オブジェクトの編集 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、クラスターおよびリソースの edit コマンドを説明します。
7.2.4.1. edit cluster リンクのコピーリンクがクリップボードにコピーされました!
既存のクラスターの編集を許可します。
構文
rosa edit cluster --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa edit cluster --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
| --additional-allowed-principals <arn> | 追加の VPC エンドポイント接続要求の自動受け入れを可能にするために Hosted Control Plane の VPC エンドポイントサービスに追加される、追加の許可済みプリンシパル ARN のコンマ区切りリスト。 |
| --cluster | 必須: 編集するクラスターの名前または ID (文字列)。 |
| --private | プライマリー API エンドポイントを直接のプライベート接続に制限します。 |
| --enable-delete-protection=true | 削除保護機能を有効にします。 |
| --enable-delete-protection=false | 削除保護機能を無効にします。 |
| --billing-account-string | AWS マーケットプレイスから購入したサブスクリプションの請求に使用するアカウントを指定します。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター mycluster を編集して、プライベートにします。
rosa edit cluster --cluster=mycluster --private
$ rosa edit cluster --cluster=mycluster --private
クラスター mycluster ですべてのクラスターオプションをインタラクティブに編集します。
rosa edit cluster --cluster=mycluster --interactive
$ rosa edit cluster --cluster=mycluster --interactive
7.2.4.2. edit ingress リンクのコピーリンクがクリップボードにコピーされました!
クラスターのデフォルトのアプリケーションルーターを編集します。
デフォルト以外のアプリケーションルーターの編集は、関連情報 を参照してください。
構文
rosa edit ingress --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa edit ingress --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: Ingress が追加されるクラスターの名前または ID (文字列)。 |
| --cluster-routes-hostname | OAuth、コンソール、ダウンロードのコンポーネントルートのホスト名。 |
| --cluster-routes-tls-secret-ref | OAuth、コンソール、ダウンロードのコンポーネントルートの TLS シークレット参照。 |
| --excluded-namespaces |
Ingress の除外対象の namespace。形式はコンマ区切りリスト |
| --label-match | Ingress のラベル一致 (文字列)。形式は、キーと値のペアのコンマ区切りリストにする必要があります。ラベルが指定されていない場合は、すべてのルートが両方のルーターで公開されます。 |
| --lb-type |
ロードバランサーのタイプ。オプションは |
| --namespace-ownership-policy |
Ingress の namespace 所有権ポリシー。オプションは |
| --private | アプリケーションルートを直接かつプライベートの接続に制限します。 |
| --route-selector | Ingress のルートセレクター。形式は key=value のコンマ区切りリストです。ラベルが指定されていない場合は、すべてのルートが両方のルーターで公開されます。従来の Ingress サポートの場合、このラベルは包含ラベルです。それ以外の場合は、除外ラベルとして扱われます。 |
| --wildcard-policy |
Ingress のワイルドカードポリシー。オプションは |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター mycluster で、プライベート接続として ID a1b2 を使用して追加の入力を行います。
rosa edit ingress --private --cluster=mycluster a1b2
$ rosa edit ingress --private --cluster=mycluster a1b2
クラスター mycluster で、ID a1b2 の追加の入力用のルーターセレクターを更新します。
rosa edit ingress --label-match=foo=bar --cluster=mycluster a1b2
$ rosa edit ingress --label-match=foo=bar --cluster=mycluster a1b2
クラスター mycluster でサブドメイン識別子 apps を使用してデフォルトの入力を更新します。
rosa edit ingress --private=false --cluster=mycluster apps
$ rosa edit ingress --private=false --cluster=mycluster apps
apps2 Ingress のロードバランサータイプを更新します。
rosa edit ingress --lb-type=nlb --cluster=mycluster apps2
$ rosa edit ingress --lb-type=nlb --cluster=mycluster apps2
7.2.4.3. edit kubeletconfig リンクのコピーリンクがクリップボードにコピーされました!
カスタム KubeletConfig オブジェクトを編集する
構文
rosa edit kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]
$ rosa edit kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> |
必須。 |
| -i, --interactive | 対話モードを有効にします。 |
| --pod-pids-limit <number> | 必須。各ノードの PID の最大数。 |
| --name |
|
| -h, --help | このコマンドのヘルプを表示します。 |
クラスターの PID 制限の設定の詳細は、PID 制限の設定 を参照してください。
7.2.4.4. edit machinepool リンクのコピーリンクがクリップボードにコピーされました!
クラスターのマシンプールへの編集を許可します。
構文
rosa edit machinepool --cluster=<cluster_name_or_id> <machinepool_name> [arguments]
$ rosa edit machinepool --cluster=<cluster_name_or_id> <machinepool_name> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: 追加のマシンプールが編集されるクラスターの名前または ID (文字列)。 |
| --enable-autoscaling |
コンピュートノードの自動スケーリングを有効または無効にします。自動スケーリングを有効にするには、 |
| --labels | マシンプールのラベル (文字列)。形式は、キーと値のペアのコンマ区切りリストにする必要があります。この値の編集は、ノード番号を増やして作成されたマシンプールの新しく作成されたノードにのみ影響し、既存のノードには影響しません。このリストは、継続的にノードラベルに加えられるすべての変更を上書きします。 |
| --kubelet-configs <kubeletconfig_name> |
マシンプール内のノードに適用する |
| --max-replicas | 自動スケーリングを有効にする際のコンピュートノードの最大数を指定します。 |
| --min-replicas | 自動スケーリングを有効にする際のコンピュートノードの最小数を指定します。 |
| --max-surge |
デフォルト値は |
| --max-unavailable |
デフォルト値は |
| --node-drain-grace-period | マシンプールをアップグレードまたは置き換えるときのノードドレイン猶予期間を指定します。 |
| --replicas | 自動スケーリングが設定されていない場合に必要です。このマシンプールのマシンの数 (整数)。 |
| --taints |
マシンプールのテイント。この文字列値は、 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター mycluster で、マシンプール mp1 に 4 つのレプリカを設定します。
rosa edit machinepool --cluster=mycluster --replicas=4 mp1
$ rosa edit machinepool --cluster=mycluster --replicas=4 mp1
クラスター mycluster で、マシンプール mp1 の自動スケーリングを有効にします。
rosa edit machinepool --cluster=mycluster --enable-autoscaling --min-replicas=3 --max-replicas=5 mp1
$ rosa edit machinepool --cluster=mycluster --enable-autoscaling --min-replicas=3 --max-replicas=5 mp1
クラスター mycluster で、マシンプール mp1 の自動スケーリングを無効にします。
rosa edit machinepool --cluster=mycluster --enable-autoscaling=false --replicas=3 mp1
$ rosa edit machinepool --cluster=mycluster --enable-autoscaling=false --replicas=3 mp1
クラスター mycluster で、マシンプール mp1 の自動スケーリング範囲を変更します。
rosa edit machinepool --max-replicas=9 --cluster=mycluster mp1
$ rosa edit machinepool --max-replicas=9 --cluster=mycluster mp1
Red Hat OpenShift Service on AWS クラスターで、mp1 マシンプールを編集して、アップグレード中に次の動作を追加します。* アップグレード中に最大 2 つの余分なノードをプロビジョニングできるようにします。* アップグレード中の使用不可ノードが 3 つ以下になるようにします。
rosa edit machinepool --cluster=mycluster mp1 --max-surge=2 --max-unavailable=3
$ rosa edit machinepool --cluster=mycluster mp1 --max-surge=2 --max-unavailable=3
KubeletConfig オブジェクトを Red Hat OpenShift Service on AWS クラスター上の既存の high-pid-pool マシンプールに関連付けます。
rosa edit machinepool -c mycluster --kubelet-configs=set-high-pids high-pid-pool
$ rosa edit machinepool -c mycluster --kubelet-configs=set-high-pids high-pid-pool
7.2.4.5. ミラーイメージ設定の編集 リンクのコピーリンクがクリップボードにコピーされました!
既存のミラーイメージ設定内のミラーリストを編集します。
イメージミラーを編集すると、新しいミラーリストによって既存のミラーリストが完全に置き換えられます。
構文
rosa edit image-mirror [arguments]
$ rosa edit image-mirror [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: Ingress が追加されるクラスターの名前または ID (文字列)。 |
| --mirrors | 必須: 現在のミラーレジストリーを置き換える新しいミラーレジストリーのリスト。ミラーレジストリーはコンマで区切る必要があります。 |
| --id | 必須: 編集するイメージミラー設定の ID。 |
| --profile | 任意: 認証情報ファイルから特定の AWS プロファイルを使用します。 |
| --region | 任意: AWS リージョンを使用し、AWS_REGION 環境変数をオーバーライドします。 |
例
すべてのミラーを置き換えます。
rosa edit image-mirror --cluster=mycluster --id=abc123def456 \ --mirrors=new-primary.company.com/team,new-secondary.company.com/team
$ rosa edit image-mirror --cluster=mycluster --id=abc123def456 \
--mirrors=new-primary.company.com/team,new-secondary.company.com/team
1 つのミラーを置き換えます。
rosa edit image-mirror --cluster=mycluster --id=abc123def456 \ --mirrors=single-mirror.company.com/team
$ rosa edit image-mirror --cluster=mycluster --id=abc123def456 \
--mirrors=single-mirror.company.com/team
7.2.6. オブジェクトの削除 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、クラスターおよびリソースの delete コマンドを説明します。
7.2.6.1. delete account-roles リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントからアカウントロールをクリーンアップします。
構文
rosa delete account-roles
$ rosa delete account-roles
| オプション | 定義 |
|---|---|
| --classic | 従来のアカウントロールを削除します |
| --delete-hcp-shared-vpc-policies | Hosted Control Plane 共有 VPC ポリシーを削除します |
| --hosted-cp | Hosted Control Plane ロールを削除します |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --prefix | 削除するアカウントロールの接頭辞。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
接頭辞が mycluster であるすべての AWS アカウントロールを削除します。
rosa delete account-roles -p mycluster
$ rosa delete account-roles -p mycluster
7.2.6.2. delete admin リンクのコピーリンクがクリップボードにコピーされました!
指定されたクラスターからクラスター管理者を削除します。
構文
rosa delete admin --cluster=<cluster_name> | <cluster_id>
$ rosa delete admin --cluster=<cluster_name> | <cluster_id>
| オプション | 定義 |
|---|---|
| --cluster | 必須: 削除するアイデンティティープロバイダー (IDP) を含むクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターからクラスター管理者を削除します。
rosa delete admin --cluster=mycluster
$ rosa delete admin --cluster=mycluster
7.2.6.3. delete cluster リンクのコピーリンクがクリップボードにコピーされました!
クラスターを削除します。
構文
rosa delete cluster --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa delete cluster --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: 削除するクラスターの名前または ID (文字列)。 |
| --watch | クラスターのアンインストールログを監視します。 |
| --best-effort |
クラスター削除プロセスの失敗の原因となることが判明しているクラスター破棄チェーンのステップをスキップします。このオプションは慎重に使用してください。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターを削除します。
rosa delete cluster --cluster=mycluster
$ rosa delete cluster --cluster=mycluster
7.2.6.4. delete external-auth-provider リンクのコピーリンクがクリップボードにコピーされました!
クラスターから外部認証プロバイダーを削除します。
構文
rosa delete external-auth-provider <name_of_external_auth_provider> --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa delete external-auth-provider <name_of_external_auth_provider> --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須。外部認証プロバイダーが削除されるクラスターの名前または ID 文字列。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターから exauth-1 という名前のアイデンティティープロバイダーを削除します。
rosa delete external-auth-provider exauth-1 --cluster=mycluster
$ rosa delete external-auth-provider exauth-1 --cluster=mycluster
7.2.6.5. delete idp リンクのコピーリンクがクリップボードにコピーされました!
クラスターから特定のアイデンティティープロバイダー (IDP) を削除します。
構文
rosa delete idp --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa delete idp --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: IDP を削除するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターから github という名前のアイデンティティープロバイダーを削除します。
rosa delete idp github --cluster=mycluster
$ rosa delete idp github --cluster=mycluster
7.2.6.6. delete ingress リンクのコピーリンクがクリップボードにコピーされました!
デフォルト以外のアプリケーションルーター (ingress) をクラスターから削除します。
構文
rosa delete ingress --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa delete ingress --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: Ingress を削除するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターから ID a1b2 の Ingress を削除します。
rosa delete ingress --cluster=mycluster a1b2
$ rosa delete ingress --cluster=mycluster a1b2
名前が mycluster のクラスターから、サブドメイン名が apps2 であるセカンダリー Ingress を削除します。
rosa delete ingress --cluster=mycluster apps2
$ rosa delete ingress --cluster=mycluster apps2
7.2.6.7. delete kubeletconfig リンクのコピーリンクがクリップボードにコピーされました!
クラスターからカスタム KubeletConfig オブジェクトを削除します。
構文
rosa delete kubeletconfig --cluster=<cluster_name|cluster_id> [flags]
$ rosa delete kubeletconfig --cluster=<cluster_name|cluster_id> [flags]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> |
必須。 |
| --name |
|
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.6.8. delete machinepool リンクのコピーリンクがクリップボードにコピーされました!
クラスターからマシンプールを削除します。
構文
rosa delete machinepool --cluster=<cluster_name> | <cluster_id> <machine_pool_id>
$ rosa delete machinepool --cluster=<cluster_name> | <cluster_id> <machine_pool_id>
| オプション | 定義 |
|---|---|
| --cluster | 必須: マシンプールが削除されるクラスターの名前または ID (文字列)。 |
| --machinepool string | ターゲットとするクラスターのマシンプール。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターから ID が mp-1 のマシンプールを削除します。
rosa delete machinepool --cluster=mycluster mp-1
$ rosa delete machinepool --cluster=mycluster mp-1
7.2.6.9. delete ocm-role リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS 組織から OCM ロールを削除します。
構文
rosa delete ocm-role --role-arn <role_arn>
$ rosa delete ocm-role --role-arn <role_arn>
| オプション | 定義 |
|---|---|
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --role-arn 文字列 | 必須: AWS アカウントのユーザーロールから削除するロール ARN |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
arn:aws:iam::123456789012:role/xxx-OCM-Role-1223456778 arn の ocm-role を削除します。
rosa delete ocm-role --role-arn arn:aws:iam::123456789012:role/xxx-OCM-Role-1223456778
$ rosa delete ocm-role --role-arn arn:aws:iam::123456789012:role/xxx-OCM-Role-1223456778
7.2.6.10. delete oidc-config リンクのコピーリンクがクリップボードにコピーされました!
登録された OIDC 設定 ID に基づいて OIDC 設定を削除します。
構文
rosa delete oidc-config --oidc-config-id <oidc_config_id>
$ rosa delete oidc-config --oidc-config-id <oidc_config_id>
| オプション | 定義 |
|---|---|
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --oidc-config-id string | 必須: OIDC 設定を識別するための登録 ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
ID が A1B2C3D4 の OIDC 設定を削除します。
rosa delete oidc-config --oidc-config-id A1B2C3D4
$ rosa delete oidc-config --oidc-config-id A1B2C3D4
7.2.6.11. delete oidc-provider リンクのコピーリンクがクリップボードにコピーされました!
削除された STS クラスターの OIDC プロバイダーを削除します。
構文
rosa delete oidc-provider --cluster=<cluster_name> | --oidc-config-id <oidc_config_id>
$ rosa delete oidc-provider --cluster=<cluster_name> | --oidc-config-id <oidc_config_id>
| オプション | 定義 |
|---|---|
| -c, --cluster string | クラスターの名前または ID。 |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --oidc-config-id string |
必須: 発行者 URL を取得するための登録済み OIDC 設定 ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
OIDC 設定 ID
A1B2C3D4を使用して OIDC プロバイダーを削除します。rosa delete oidc-provider --oidc-config-id A1B2C3D4
$ rosa delete oidc-provider --oidc-config-id A1B2C3D4Copy to Clipboard Copied! Toggle word wrap Toggle overflow クラスター名
myclusterを使用して OIDC プロバイダーを削除します。rosa delete oidc-provider --cluster=mycluster
$ rosa delete oidc-provider --cluster=myclusterCopy to Clipboard Copied! Toggle word wrap Toggle overflow
7.2.6.12. delete operator-roles リンクのコピーリンクがクリップボードにコピーされました!
削除された STS クラスターの Operator ロールを削除します。
構文
rosa delete oidc-provider --cluster=<cluster_name> | --oidc-config-id <oidc_config_id>
$ rosa delete oidc-provider --cluster=<cluster_name> | --oidc-config-id <oidc_config_id>
| オプション | 定義 |
|---|---|
| -c, --cluster string | クラスターの名前または ID。 |
| --delete-hcp-shared-vpc-policies | Hosted Control Plane 共有 VPC ポリシーを削除します。 |
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --prefix 文字列 | Operator ロールの接頭辞。再利用可能な OIDC 設定の場合は、このフラグを使用する必要があります。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターにある operator-roles を削除します。
rosa delete operator-roles --cluster=mycluster
$ rosa delete operator-roles --cluster=mycluster
7.2.6.13. delete tuning-configs リンクのコピーリンクがクリップボードにコピーされました!
指定されたクラスター上の指定された tuning 設定を削除します。
構文
rosa delete tuning-config --cluster=<cluster_name> <tuning_config_name>
$ rosa delete tuning-config --cluster=<cluster_name> <tuning_config_name>
| オプション | 定義 |
|---|---|
| -c, --cluster string | クラスターの名前または ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターから、tuned1 という名前の tuning 設定を削除します。
rosa delete tuning-config --cluster=mycluster tuned1
$ rosa delete tuning-config --cluster=mycluster tuned1
7.2.6.14. delete upgrade リンクのコピーリンクがクリップボードにコピーされました!
スケジュールされたクラスターのアップグレードをキャンセルします。
構文
rosa delete upgrade
$ rosa delete upgrade
| オプション | 定義 |
| -c, --cluster string | クラスターの名前または ID。 |
| --machinepool string | ターゲットとするクラスターのマシンプール。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
接頭辞が rh-user で、ユーザーロール名が Auditor であるユーザーロールを削除します。
rosa delete user-role --role-arn rh-user-User-Auditor-Role
$ rosa delete user-role --role-arn rh-user-User-Auditor-Role
7.2.6.15. delete user-role リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントからユーザーロールを削除します。
構文
rosa delete user-role
$ rosa delete user-role
| オプション | 定義 |
|---|---|
| -m, --mode string | 操作の実行方法。有効なオプションは以下のとおりです。
|
| --role-arn 文字列 | 必須: AWS アカウントから削除するユーザーロールの ARN。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
接頭辞が rh-user で、ユーザーロール名が Auditor であるユーザーロールを削除します。
rosa delete user-role --role-arn rh-user-User-Auditor-Role
$ rosa delete user-role --role-arn rh-user-User-Auditor-Role
7.2.7. アドオンのインストールおよびアンインストール リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、クラスターに Red Hat マネージドサービスアドオンをインストールおよびアンインストールする方法を説明します。
7.2.7.1. install addon リンクのコピーリンクがクリップボードにコピーされました!
クラスターにマネージドサービスアドオンをインストールします。
構文
rosa install addon --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa install addon --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: アドオンがインストールされるクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --profile | 認証情報ファイルから特定の AWS プロファイル (文字列) を使用します。 |
| --yes |
操作を確認するために、自動的に |
例
mycluster という名前のクラスターに dbaas-operator アドオンインストールを追加します。
rosa install addon --cluster=mycluster dbaas-operator
$ rosa install addon --cluster=mycluster dbaas-operator
7.2.7.2. uninstall addon リンクのコピーリンクがクリップボードにコピーされました!
クラスターからマネージドサービスアドオンをアンインストールします。
構文
rosa uninstall addon --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa uninstall addon --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: アドオンのアンインストール元となるクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --profile | 認証情報ファイルから特定の AWS プロファイル (文字列) を使用します。 |
| --yes |
操作を確認するために、自動的に |
例
mycluster という名前のクラスターから dbaas-operator アドオンインストールを削除します。
rosa uninstall addon --cluster=mycluster dbaas-operator
$ rosa uninstall addon --cluster=mycluster dbaas-operator
7.2.8. オブジェクトのリスト表示および説明 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、クラスターおよびリソースの list コマンドおよび describe コマンドを説明します。
7.2.8.1. describe access-request リンクのコピーリンクがクリップボードにコピーされました!
アクセス要求に関する詳細情報を表示します。
構文
rosa describe describe access-request --id <access_request_id>
$ rosa describe describe access-request --id <access_request_id>
| オプション | 定義 |
|---|---|
| --id string | 必須。アクセス要求の ID。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
ID が A1B2C3D4 のアクセス要求の詳細を表示し、結果を .yaml 出力で生成します。
rosa describe describe access-request --id A1B2C3D4 -output yaml
$ rosa describe describe access-request --id A1B2C3D4 -output yaml
7.2.8.2. list access-request リンクのコピーリンクがクリップボードにコピーされました!
ステータスが Pending または Approved のアクセス要求をすべて表示します。'--cluster' フラグを使用すると、CLI は指定されたクラスターのすべてのステータスのアクセス要求を表示します。
構文
rosa list access-request [arguments]
$ rosa list access-request [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster string | 必須: マシンプールをリスト表示するクラスターの名前または ID (文字列)。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター foo のアクセス要求をすべて表示します。
rosa list access-request --cluster foo
$ rosa list access-request --cluster foo
7.2.8.3. list account-roles リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントのすべてのアカウントロールとポリシーを表示します。
構文
rosa list account-roles [arguments]
$ rosa list account-roles [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster string | 必須: マシンプールをリスト表示するクラスターの名前または ID (文字列)。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
アカウントに関連付けられているすべての AWS アカウントロールを表示します。
rosa list account-roles
$ rosa list account-roles
7.2.8.4. describe addon-installation リンクのコピーリンクがクリップボードにコピーされました!
アドオンのインストールに関する詳細情報を表示します。
| オプション | 定義 |
|---|---|
| -c, --cluster string | 必須: マシンプールをリスト表示するクラスターの名前または ID (文字列)。 |
| --addon string | 必須: アドオンインストールの名前または ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター foo への bar アドオンのインストールの詳細を表示します。
rosa describe addon-installation --cluster foo --addon bar
$ rosa describe addon-installation --cluster foo --addon bar
7.2.8.5. describe admin リンクのコピーリンクがクリップボードにコピーされました!
指定された cluster-admin ユーザーの詳細と、クラスターにログインするためのコマンドを表示します。
構文
rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: cluster-admin が属するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの cluster-admin ユーザの情報を表示します。
rosa describe admin --cluster=mycluster
$ rosa describe admin --cluster=mycluster
7.2.8.6. describe addon リンクのコピーリンクがクリップボードにコピーされました!
管理対象サービスのアドオンの詳細を表示します。
構文
rosa describe addon <addon_id> | <addon_name> [arguments]
$ rosa describe addon <addon_id> | <addon_name> [arguments]
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が dbaas-operator のアドオン情報を表示します。
rosa describe addon dbaas-operator
$ rosa describe addon dbaas-operator
7.2.8.7. list addon リンクのコピーリンクがクリップボードにコピーされました!
管理対象サービスのアドオンのインストールを表示します。
構文
rosa list addons [arguments]
$ rosa list addons [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: アドオンをリスト表示するクラスターの名前または ID (文字列)。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が cluster のクラスターのアドオンインストールをすべて表示します。
rosa list addons --cluster=mycluster
$ rosa list addons --cluster=mycluster
7.2.8.8. describe break-glass-credential リンクのコピーリンクがクリップボードにコピーされました!
特定クラスターのブレークグラス認証情報の詳細を表示します。
構文
rosa describe break-glass-credential --id=<break_glass_credential_id> --cluster=<cluster_name>| <cluster_id> [arguments]
$ rosa describe break-glass-credential --id=<break_glass_credential_id> --cluster=<cluster_name>| <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --id | 必須: ブレークグラス認証情報の ID (文字列)。 |
| --kubeconfig | 任意: ブレークグラス認証情報から kubeconfig を取得します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.9. List break-glass-credential リンクのコピーリンクがクリップボードにコピーされました!
クラスターのすべてのブレークグラス認証情報を表示します。
構文
rosa list break-glass-credential [arguments]
$ rosa list break-glass-credential [arguments]
| オプション | 定義 |
|---|---|
| --cluster <cluster_name>|<cluster_id> | 必須。ブレークグラス認証情報が追加されたクラスターの名前または ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターのブレークグラス認証情報をすべて表示します。
rosa list break-glass-credential --cluster=mycluster
$ rosa list break-glass-credential --cluster=mycluster
7.2.8.10. describe cluster リンクのコピーリンクがクリップボードにコピーされました!
クラスターの詳細を表示します。
構文
rosa describe cluster [arguments]
$ rosa describe cluster [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --external-id <arn_string> | 別のアカウントでロールを引き受けるときに必要となる可能性があるオプションの一意識別子。 |
| --get-role-policy-bindings | クラスターに割り当てられた STS ロールにアタッチされているポリシーをリスト表示します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの情報を表示します。
rosa describe cluster --cluster=mycluster
$ rosa describe cluster --cluster=mycluster
7.2.8.11. list clusters リンクのコピーリンクがクリップボードにコピーされました!
すべてのクラスターを表示します。
構文
rosa list clusters [flag]
$ rosa list clusters [flag]
| オプション | 定義 |
| -a、--all | 同じ Red Hat 組織内のさまざまな AWS アカウントのクラスターをすべて表示します。 |
| -o、--output string |
出力形式を指定します。 |
| --get-role-policy-bindings | クラスターに割り当てられた STS ロールにアタッチされているポリシーをリスト表示します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.12. list dns-domain リンクのコピーリンクがクリップボードにコピーされました!
すべての DNS ドメインを表示します。
構文
rosa list dns-domain [arguments]
$ rosa list dns-domain [arguments]
| オプション | 定義 |
|---|---|
| -a、--all | すべての DNS ドメインを表示します。デフォルトのオプションには、ユーザー定義のドメインのみがリストされます。 |
| --hosted-cp | Hosted Control Plane クラスターに使用される DNS ドメインのみにリストをフィルタリングします。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
組織 ID に関連付けられているすべての DNS ドメインを表示します。
rosa list dns-domain
$ rosa list dns-domain
7.2.8.13. 外部認証プロバイダーの説明 リンクのコピーリンクがクリップボードにコピーされました!
クラスター上の外部認証プロバイダーに関する詳細情報を表示します。
構文
rosa describe external-auth-provider [arguments]
$ rosa describe external-auth-provider [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --name string | ターゲットとするクラスターの外部認証プロバイダーの名前。 |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの exauth という名前の外部認証プロバイダーの詳細を表示します。
rosa describe external-auth-provider exauth --cluster=mycluster
$ rosa describe external-auth-provider exauth --cluster=mycluster
7.2.8.14. list external-auth-provider リンクのコピーリンクがクリップボードにコピーされました!
クラスターの外部認証プロバイダーを表示します。
構文
rosa list external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa list external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: 外部認証プロバイダーがリストされるクラスターの名前または ID 文字列。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの外部認証プロバイダーをすべて表示します。
rosa list external-auth-provider --cluster=mycluster
$ rosa list external-auth-provider --cluster=mycluster
7.2.8.15. list gates リンクのコピーリンクがクリップボードにコピーされました!
特定の OCP リリースまたはクラスターアップグレードバージョンごとに利用可能なすべての OCP ゲートを表示します。
構文
rosa list gates [arguments]
$ rosa list gates [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --gate string |
ゲートタイプ。オプションは |
| -o、--output string |
出力形式を指定します。 |
| --version 文字列 | 指定された OpenShift バージョン。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
OCP バージョンのすべての OCP ゲートを表示します。
rosa list gates --version 4.19
$ rosa list gates --version 4.19Copy to Clipboard Copied! Toggle word wrap Toggle overflow OCP バージョンのすべての STS ゲートを表示します。
rosa list gates --gate sts --version 4.19
$ rosa list gates --gate sts --version 4.19Copy to Clipboard Copied! Toggle word wrap Toggle overflow OCP バージョンのすべての OCP ゲートを表示します。
rosa list gates --gate ocp --version 4.19
$ rosa list gates --gate ocp --version 4.19Copy to Clipboard Copied! Toggle word wrap Toggle overflow クラスターのアップグレードバージョンで使用可能なゲートを表示します。
rosa list gates -c mycluster --version 4.19.7
$ rosa list gates -c mycluster --version 4.19.7Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.2.8.16. list idps リンクのコピーリンクがクリップボードにコピーされました!
クラスターのすべてのアイデンティティープロバイダー (IDP) を表示します。
構文
rosa list idps [arguments]
$ rosa list idps [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: IDP をリスト表示するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターのアイデンティティープロバイダー (IDP) をすべて表示します。
rosa list idps --cluster=mycluster
$ rosa list idps --cluster=mycluster
7.2.8.17. describe ingress リンクのコピーリンクがクリップボードにコピーされました!
クラスター内の指定された Ingress の詳細情報を表示します。
構文
rosa describe ingress [ingress]
$ rosa describe ingress [ingress]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --ingress string | ターゲットとするクラスターの Ingress を指定します |
| -o、--output string |
出力形式を指定します。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスター上の a1b2c3d4 という Ingress の詳細を表示します。
rosa describe ingress a1b2c3d4 -c mycluster
$ rosa describe ingress a1b2c3d4 -c mycluster
7.2.8.18. list ingresses リンクのコピーリンクがクリップボードにコピーされました!
クラスターのすべての API および Ingress エンドポイントをリスト表示します。
構文
rosa list ingresses [arguments]
$ rosa list ingresses [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: IDP をリスト表示するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの API および Ingress エンドポイントをすべて表示します。
rosa list ingresses --cluster=mycluster
$ rosa list ingresses --cluster=mycluster
7.2.8.19. list instance-types リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Service on AWS で使用できるすべてのインスタンスタイプをリスト表示します。可用性は、アカウントの AWS クォータに基づいています。
構文
rosa list instance-types [arguments]
$ rosa list instance-types [arguments]
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
すべてのインスタンスタイプをリスト表示します。
rosa list instance-types
$ rosa list instance-types
7.2.8.20. describe kubeletconfig リンクのコピーリンクがクリップボードにコピーされました!
カスタム KubeletConfig オブジェクトの詳細を表示します。
構文
rosa describe kubeletconfig --cluster=<cluster_name|cluster_id> [arguments]
$ rosa describe kubeletconfig --cluster=<cluster_name|cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> |
必須。 |
| -h, --help | このコマンドのヘルプを表示します。 |
| --name |
必須。記述する |
| -o、--output string |
出力フォーマット。 |
7.2.8.21. list kubeletconfigs リンクのコピーリンクがクリップボードにコピーされました!
クラスターに設定されている KubeletConfig オブジェクトをリスト表示します。
構文
rosa list kubeletconfigs --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa list kubeletconfigs --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。マシンプールがリスト表示されるクラスターの名前または ID。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターの KubeletConfig オブジェクトをすべて表示します。
rosa list kubeletconfigs --cluster=mycluster
$ rosa list kubeletconfigs --cluster=mycluster
7.2.8.22. describe machinepool リンクのコピーリンクがクリップボードにコピーされました!
クラスター上に設定された特定のマシンプールを記述します。
構文
rosa describe machinepool --cluster=[<cluster_name>|<cluster_id>] --machinepool=<machinepool_name> [arguments]
$ rosa describe machinepool --cluster=[<cluster_name>|<cluster_id>] --machinepool=<machinepool_name> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --machinepool | 必須: マシンプールの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスター上の mymachinepool という名前のマシンプールの情報を表示します。
rosa describe machinepool --cluster=mycluster --machinepool=mymachinepool
$ rosa describe machinepool --cluster=mycluster --machinepool=mymachinepool
7.2.8.23. list machinepools リンクのコピーリンクがクリップボードにコピーされました!
クラスターに設定されているマシンプールを表示します。
構文
rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: マシンプールをリスト表示するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスター上のすべてのマシンプールをリスト表示します。
rosa list machinepools --cluster=mycluster
$ rosa list machinepools --cluster=mycluster
7.2.8.24. list ocm-roles リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントの OCM ロールをすべて表示します。
構文
rosa list ocm-roles [arguments]
$ rosa list ocm-roles [arguments]
| オプション | 定義 |
|---|---|
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.25. list oidc-config リンクのコピーリンクがクリップボードにコピーされました!
AWS アカウントに関連付けられている OIDC 設定リソースをリスト表示します。
構文
rosa list oidc-config
$ rosa list oidc-config
| オプション | 定義 |
|---|---|
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.26. list oidc-providers リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントのすべての OIDC プロバイダーを表示します。
構文
rosa list oidc-providers [arguments]
$ rosa list oidc-providers [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。OIDC プロバイダーがリストされるクラスターの名前または ID。 |
| --oidc-config-id string | この引数は、OIDC config ID によって OIDC プロバイダーをフィルタリングします。config ID にリンクされた 1 つのプロバイダーを返します。 |
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.27. list operator-roles リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントのすべての Operator のロールとポリシーを表示します。
構文
rosa list operator-roles [arguments]
$ rosa list operator-roles [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。クラスターの名前または ID。 |
| -o、--output string |
出力フォーマット。 |
| --prefix 文字列 | 指定された接頭辞に関連付けられている Operator ロールのみをリスト表示します。接頭辞は `openshift kube-system` (という文字列) まで一致する必要があります |
| 。 | --version 文字列 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.28. list regions リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントで利用可能なすべてのリージョンを表示します。
構文
rosa list regions [arguments]
$ rosa list regions [arguments]
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
利用可能なすべてのリージョンを表示します。
rosa list regions
$ rosa list regions
7.2.8.29. describe tuning-configs リンクのコピーリンクがクリップボードにコピーされました!
クラスターの tuning 設定に関する詳細情報を表示します。
構文
rosa describe tuning-config --cluster <cluster-name-or-id> <tuning-name>
$ rosa describe tuning-config --cluster <cluster-name-or-id> <tuning-name>
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。クラスターの名前または ID。 |
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
クラスター foo 上の tuned1 チューニング設定の詳細を表示します。
rosa describe tuning-config --cluster foo tuned1
$ rosa describe tuning-config --cluster foo tuned1
7.2.8.30. list tuning-configs リンクのコピーリンクがクリップボードにコピーされました!
クラスターの tuning 設定リソースを表示します。
構文
rosa list tuning-configs --cluster <cluster-name-or-id>
$ rosa list tuning-configs --cluster <cluster-name-or-id>
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。クラスターの名前または ID。 |
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターにある tuning 設定をすべて表示します。
rosa list tuning-configs -c mycluster
$ rosa list tuning-configs -c mycluster
7.2.8.31. describe upgrade リンクのコピーリンクがクリップボードにコピーされました!
アップグレードに関する詳細情報を表示します。
構文
rosa describe upgrade [arguments]
$ rosa describe upgrade [arguments]
| オプション | 定義 |
|---|---|
| -c, --cluster <cluster_name>|<cluster_id> | 必須。クラスターの名前または ID。 |
| --machinepool string | ターゲットとするクラスターのマシンプールの名前。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.32. list upgrades リンクのコピーリンクがクリップボードにコピーされました!
利用可能かつスケジュールされているすべてのクラスターバージョンアップグレードを表示します。
構文
rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: 利用可能なアップグレードをリスト表示するクラスターの名前または ID (文字列)。 |
| --machinepool string | ターゲットとするクラスターのマシンプールの名前。 |
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターで利用可能なアップグレードをすべて表示します。
rosa list upgrades --cluster=mycluster
$ rosa list upgrades --cluster=mycluster
7.2.8.33. list user-roles リンクのコピーリンクがクリップボードにコピーされました!
現在の AWS アカウントのユーザーロールをすべて表示します。
構文
rosa list user-roles
$ rosa list user-roles
| オプション | 定義 |
|---|---|
| -o、--output string |
出力フォーマット。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
7.2.8.34. list users リンクのコピーリンクがクリップボードにコピーされました!
指定されたクラスターのクラスター管理者と専用管理者ユーザーを表示します。
構文
rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスター管理者をリスト表示するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
名前が mycluster のクラスターのクラスター管理者と専用管理者をすべて表示します。
rosa list users --cluster=mycluster
$ rosa list users --cluster=mycluster
7.2.8.35. list versions リンクのコピーリンクがクリップボードにコピーされました!
クラスターの作成に使用できるすべての OpenShift バージョンをリスト表示します。
構文
rosa list versions [arguments]
$ rosa list versions [arguments]
| オプション | 定義 |
|---|---|
| --help, -h | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --interactive | 対話モードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
Red Hat OpenShift Service on AWS のすべてのバージョンをリスト表示します。
rosa list versions
$ rosa list versions
7.2.9. オブジェクトの取り消し リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、クラスターとリソースの revoke コマンドを説明します。
7.2.9.1. revoke-break-glass-credential リンクのコピーリンクがクリップボードにコピーされました!
外部認証が有効な指定した Red Hat OpenShift Service on AWS クラスターから、すべてのブレークグラス認証情報を取り消します。
構文
rosa revoke break-glass-credential --cluster=<cluster_name> | <cluster_id>
$ rosa revoke break-glass-credential --cluster=<cluster_name> | <cluster_id>
| オプション | 定義 |
|---|---|
| --cluster | 必須: ブレークグラス認証情報を削除するクラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
| --yes |
操作を確認するために、自動的に |
例
mycluster という名前のクラスターからブレークグラス認証情報を取り消します。
rosa revoke break-glass-credential --cluster=mycluster
$ rosa revoke break-glass-credential --cluster=mycluster
7.2.10. オブジェクトのアップグレードおよびアップグレードの削除 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、オブジェクトの upgrade コマンドの使用を説明します。
7.2.10.1. upgrade cluster リンクのコピーリンクがクリップボードにコピーされました!
クラスターのアップグレードをスケジュールします。
構文
rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]
$ rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]
| オプション | 定義 |
|---|---|
| --cluster | 必須: アップグレードがスケジュールされるクラスターの名前または ID (文字列)。 |
| --interactive | 対話モードを有効にします。 |
| --version | クラスターをアップグレードする OpenShift Container Platform のバージョン (文字列) です。 |
| --schedule-date |
協定世界時 (UTC) で指定された時刻にアップグレードが実行される次の日付 (文字列)。形式は、 |
| --schedule-time |
次回のアップグレードは、協定世界時 (UTC) で指定された日付に実行されます。形式は、 |
| --control-plane | クラスターの Hosted Control Plane をアップグレードします。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
例
mycluster という名前のクラスターでアップグレードをインタラクティブにスケジュールします。
rosa upgrade cluster --cluster=mycluster --interactive
$ rosa upgrade cluster --cluster=mycluster --interactive
mycluster という名前のクラスターで、1 時間以内にクラスターアップグレードをスケジュールします。
rosa upgrade cluster --cluster=mycluster --version 4.5.20
$ rosa upgrade cluster --cluster=mycluster --version 4.5.20
7.2.10.2. クラスターのアップグレードの削除 リンクのコピーリンクがクリップボードにコピーされました!
スケジュールされたクラスターアップグレードをキャンセルします。
構文
rosa delete upgrade --cluster=<cluster_name> | <cluster_id>
$ rosa delete upgrade --cluster=<cluster_name> | <cluster_id>
| オプション | 定義 |
|---|---|
| --cluster | 必須: アップグレードがキャンセルされるクラスターの名前または ID (文字列) です。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --yes |
操作を確認するために、自動的に |
7.2.10.3. upgrade machinepool リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Service on AWS クラスターに設定されている特定のマシンプールをアップグレードします。
構文
rosa upgrade machinepool --cluster=<cluster_name> <machinepool_name>
$ rosa upgrade machinepool --cluster=<cluster_name> <machinepool_name>
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| --schedule-date |
協定世界時 (UTC) で指定された時刻にアップグレードが実行される次の日付 (文字列)。形式は、 |
| --schedule-time |
次回のアップグレードは、協定世界時 (UTC) で指定された日付に実行されます。形式は、 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |
例
mycluster という名前のクラスター上のマシンプールをアップグレードします。
rosa upgrade machinepool --cluster=mycluster
$ rosa upgrade machinepool --cluster=mycluster
7.2.10.4. マシンプールアップグレードの削除 リンクのコピーリンクがクリップボードにコピーされました!
スケジュールされたマシンプールアップグレードをキャンセルします。
構文
rosa delete upgrade --cluster=<cluster_name> <machinepool_name>
$ rosa delete upgrade --cluster=<cluster_name> <machinepool_name>
| オプション | 定義 |
|---|---|
| --cluster | 必須: クラスターの名前または ID (文字列)。 |
| オプション | 定義 |
|---|---|
| --help | このコマンドのヘルプを表示します。 |
| --debug | デバッグモードを有効にします。 |
| --profile | 認証情報ファイルから AWS プロファイル (文字列) を指定します。 |