切断された使用について

切断された使用量は何を意味しますか?

Satellite ロケーションと Red Hat OpenShift on IBM Cloud が IBM Cloudの親 managed-from 地域から切断されている場合でも、一定の時間制限付きで実行できます。 切断された使用の制限には、セキュリティー修正もアラートも含まれません。 詳しくは、 Disconnected usage by component を参照してください。

アクセス・トークンの有効期間を設定するにはどうすればよいですか?

accessTokenMaxAgeSeconds パラメーターの値を編集して、トークンの有効期間を秒単位で設定します。 詳しくは、 切断された使用時間の設定 を参照してください。

トークンの有効期限が切れたらどうなりますか？

トークンの有効期限が切れると、ロケーションを操作できなくなります。 コマンドを実行すると、 error: You must be logged in to the server (Unauthorized) などのエラー・メッセージが表示されます。 リカバリーするには、ロケーションに再接続し、再度ログインして新しいトークンを取得する必要があります。 ロケーションが再接続される前にノードを再ロードしないでください。 ロケーションが切断されているときにノードを再ロードしても、ロケーションは復旧しません。

ロケーションを再作成する必要がありますか?

いいえ、ロケーションを再作成する必要はありません。 既存のロケーションを再接続し、再認証することで、ロケーションでの作業を継続することができます。

再認証するにはどうすればよいですか？

まずロケーションに再接続してから、資格情報を使用して再度ログインしてください。

etcd バックアップをリカバリーする必要がありますか?

Red Hat （ CoreOS、RHCOS）ホストを使用している場合は、 etcd のバックアップを復元する必要はありません。 再接続し、再認証すると、ロケーションは自動的に回復します。 Red Hat Enterprise Linux （RHEL）を使用している環境では、 etcd による復旧が必要です。

ロケーションが 7 日を超えて切断されたままになっている場合はどうなりますか?

接続を復旧させた後は、その拠点内のすべてのホストを新しいインフラストラクチャに置き換える必要があります。 7日間（168時間）の上限は、 OpenShift OAuth のサーバー設定にある「 accessTokenMaxAgeSeconds 」の上限値（604800秒）によって設定されています。

ロケーションを再接続するタイミングを確認するにはどうすればよいですか?

7 日間の時間枠が期限切れになる前にロケーションを再接続するようにメモを作成するか、リマインダーを設定することができます。 トークンを要求すると、タイマーが開始します。

切断された使用時間の設定

ロケーションおよびクラスターは、 IBM Cloud から切断された状態で最大 168 時間（7 日間）稼働可能です。 OpenShift OAuth の設定にある accessTokenMaxAgeSeconds を編集して、期間を設定します。

この設定を変更するには、すべての OAuth クライアントの accessTokenMaxAgeSeconds の値を変更してください。 accessTokenMaxAgeSeconds パラメータのデフォルト値は86400秒です。

accessTokenMaxAgeSeconds 値は、ロケーションが切断されたときではなく、ユーザーが最後に認証されたときにカウントを開始します。 なお、認証を行うには、ユーザーが Identity and Access Management （IAM）へのアクセス権を持っている必要があります。

1. oc get oauthclients を実行して、 OAuth のクライアントを取得してください。

   出力例

   NAME                           SECRET                                        WWW-CHALLENGE   TOKEN-MAX-AGE   REDIRECT URIS
   console                        OBXIvSxQx2t5ANYe5-xAEylpsbdytupjyjJicScdFsE   false           default         https://console-openshift-console.sl-disc2b-be7d0adc45c89a3b4c1f8e7bc127f800-0000.eu-de.containers.appdomain.cloud/auth/callback
   openshift-browser-client       Mohc6XH48KzDywCWf-oP2SaKbI70KL1O              false           default         https://sb5041d7cf0af9630b92f-6b64a6ccc9c596bf59a86625d8fa2202-ce00.eu-de.satellite.appdomain.cloud:30048/oauth/token/display
   

2. oc get oauthaccesstokens を実行して、 OAuth のアクセストークンを取得してください。

3. 手順 1 で取得した各「 OAuth 」クライアントについて、 oc edit oauthclients console を実行し、最初の行に「 accessTokenMaxAgeSeconds: 604800 」を追加して、 accessTokenMaxAgeSeconds の値を設定してください。 なお、この手順は、すべての OAuth クライアントに対して繰り返す必要があります。

4. オプションで、 oc get oauthclients console -o yaml を実行して、yaml ファイルの最初の行が accessTokenMaxAgeSeconds: 604800 に更新されたかどうかを確認します。

5. ibmcloud ks cluster master refresh --cluster CLUSTERID を実行してクラスターをリフレッシュし、変更を有効にします。

6. 次のコマンドを実行し、 OAuth クライアントの accessTokenMaxAgeSeconds 値が更新されたことを確認してください。

   oc get oauthclients -o json | jq -j '.items[]|"Name:\t", .metadata.name, "\t", "value:\t", .accessTokenMaxAgeSeconds, "\n"'
   

コンポーネントごとの切断された使用量

以下の表では、ロケーションが切断された状態で稼働している場合のさまざまなコンポーネントの動作と制限について説明します。