コンテナ・インスタンスの操作

この項では、コンテナ・インスタンスの作成方法、コンテナ・インスタンスとそのコンテナに関する情報の表示方法、コンテナ・インスタンスの名前とタグの更新方法、およびコンテナ・インスタンスの削除方法について説明します。 コンテナ・インスタンスを停止、起動および再起動し、コンテナ・インスタンスを新しいコンパートメントに移動できます。 コンテナ・インスタンスを作成すると、インスタンスにコンテナが作成されます。

コンテナ・インスタンスの作成

Private Cloud Applianceコンテナ・インスタンスには、単一のコンテナが含まれます。

コンテナ・インスタンスを作成するために指定する必要がある最小限の情報は、次のとおりです:

  • コンテナ・インスタンスを作成するコンパートメント

  • シェイプ

  • VCNおよびサブネット

コンテナ・インスタンスは、コンテナ・インスタンスとコンテナ間で共有される15 GBのエフェメラル・ストレージを活用します。 このエフェメラル・ストレージは、コンテナ・インスタンスの作成時に自動的に作成されます。 ストレージを手動で作成し、コンテナ・インスタンスにアタッチすることはできません。

「コンピュートWeb UI」の使用

  1. ダッシュボードで、「コンテナ / コンテナ・インスタンス」を選択します。

  2. 「コンテナ・インスタンス」リストの上にある「コンテナ・インスタンスの作成」ボタンを選択します。

  3. 「コンテナ・インスタンスの作成」ダイアログで、次の情報を入力します:

    • 名前: コンテナ・インスタンスの名前を入力します。 インスタンス名には次の特性があります:

      • コンテナ・インスタンスの作成後に変更できます。

      • 一意である必要はありません。

      • 英数字とハイフン(-)文字のみを使用できます。

      • 最大63文字を指定できます。

    • 一般情報

      • コンパートメントに作成: コンテナ・インスタンスを作成するコンパートメントを選択します。

      • フォルト・ドメイン: (オプション)フォルト・ドメインを選択します。 デフォルトでは、インスタンスの作成時に、コンテナ・インスタンスに最適なフォルト・ドメインが自動的に選択されます。 フォルト・ドメインを指定し、リクエストされたフォルト・ドメインがコンテナ・インスタンスに対応できない場合、インスタンスの作成は失敗します。 フォルト・ドメインは、コンテナ・インスタンスの作成後に変更できます。

    • シェイプ: CI.Standard.x86.GenericシェイプまたはCI.Standard.E5.Flexシェイプを選択します。 これらのシェイプの詳細は、「Oracle Private Cloud Appliance概要ガイド」「コンテナ・インスタンス」を参照してください。

      スライダを使用して、必要なOCPUの数と必要なメモリーの合計量をギガバイトで指定します。

    • VNIC

      • 名前: VNICの名前を入力します。 デフォルトでは、コンテナ・インスタンス名が使用されます。

      • ネットワーク

        • プライベートIP: (オプション)使用するプライベートIPアドレスを入力します。

        • ホスト名: (オプション)クラウド・ネットワーク内でDNSを使用している場合は、ホスト名を入力します。 ホスト名は、サブネット内のすべてのVNICで一意である必要があります。 デフォルトでは、コンテナ・インスタンス名がホスト名に使用されます。

        • パブリックIPの割当て: このボックスはデフォルトで選択されています。 このコンテナ・インスタンスにパブリックIPアドレスを割り当てない場合は、このボックスの選択を解除します。

      • サブネット

        1. VCN: リストからVCNを選択します。 コンパートメントを、VCNが配置されているコンパートメントに変更する必要がある場合があります。

        2. サブネット: リストからサブネットを選択します。

    • コンテナ・イメージURL: コンテナ・インスタンスの起動に使用するイメージのURLを入力します。 任意の外部レジストリからコンテナ・イメージを指定します。 イメージは、既知の認証局によって署名され、イメージ・マニフェストは最新バージョンである必要があります。

    • タグ付け: (オプション) リソース作成時のタグの追加の説明に従って、このインスタンスの定義済タグまたはフリー・フォーム・タグを追加します。 タグは後で適用することもできます。

  4. ダイアログで「コンテナ・インスタンスの作成」ボタンを選択します。

    インスタンス詳細ページが表示されます。 「コンテナ・インスタンス情報」タブの「シェイプ構成」セクションには、シェイプ、OCPUの数、ネットワーク帯域幅および合計メモリーが表示されます。 「プライマリVNIC」列には、VCNとサブネット、プライマリ・プライベートIPアドレスと割り当てられたパブリックIPアドレス、およびMACアドレスが表示されます。

    コンテナ・インスタンス作成のステータスを確認するには、「リソース」セクションまでスクロールし、「作業リクエスト」を選択します。

    「リソース」セクションで「コンテナ」を選択します。 コンテナの名前はcomputecontainer-unique_IDです。 「コンテナ・インスタンスでのコンテナの操作」を参照してください。

OCI CLIの使用

  1. 次の情報を取得します:

    • コンテナ・インスタンスを作成するコンパートメントのOCID: oci iam compartment list

    • 使用するシェイプの名前。 次のコマンドを使用して、使用可能なシェイプとその特性をリストします。 インスタンスを作成するコンパートメントのOCIDを使用します。 これらのシェイプの詳細は、「Oracle Private Cloud Appliance概要ガイド」「コンテナ・インスタンス」を参照してください。

      $ oci container-instances container-instance list-shapes --compartment-id compartment_OCID

      次の例に示すように、シェイプ構成も指定する必要があります。 ocpusの値を指定する必要があります。また、memoryInGBsを指定できます。

      --shape-config '{"ocpus": 2, "memoryInGBs": 2}'
    • コンテナ・インスタンスの起動に使用するイメージのURL。 任意の外部レジストリからコンテナ・イメージを指定します。 イメージは、既知の認証局によって署名され、イメージ・マニフェストは最新バージョンである必要があります。

  2. --vnicsオプションの引数を作成します。

    これは、このコンテナ・インスタンスのコンテナで使用可能なネットワークのリストです。 VNICごとに、VNICの名前、使用するサブネットのOCID、プライベートIPアドレス、およびパブリックIPアドレスを割り当てる必要があるかどうかを指定します。

    この引数の構文を表示するには、次のコマンドを使用します:

    $ oci container-instances container-instance create --generate-param-json-input vnics
  3. コンテナ・インスタンスの作成コマンドを実行します。

    構文:

    必須パラメータのみが表示されます。

    oci container-instances container-instance create --availability-domain AD-1 \
    --compartment-id compartment_OCID --containers '[{"imageUrl": "image_url"}]' \
    --shape shape --shape-config '{"ocpus": 2}' \
    --vnics file://network_cofig.json

    例:

    コンテナ・インスタンスの表示名を設定する場合は、特性について「コンピュートWeb UI」プロシージャを参照してください。

    必須パラメータとオプション・パラメータの完全なリストについては、次のコマンドを使用します:

    $ oci compute instance launch -h
    $ oci container-instances container-instance create --availability-domain AD-1 \
    --compartment-id ocid1.compartment.unique_ID --containers file://container_config.json \
    --shape CI.Standard.E5.Flex --shape-config '{"ocpus": 2,"memoryInGBs": 2}' \
    --vnics '[{"subnetId": "ocid1.subnet.unique_ID"}]'

    作業リクエストを表示して、コンテナ・インスタンスの作成ステータスをモニターします。 作業リクエストOCIDは、コンテナ・インスタンス作成出力で返されます。

    $ oci container-instances work-request get --work-request-id ocid1.workrequest.unique_ID

    コンテナ・インスタンス作成のステータスが「失敗」の場合は、作業リクエストでレポートされたエラーをリストします:

    $ oci container-instances work-request list-errors --work-request-id ocid1.workrequest.unique_ID

コンテナ・インスタンスの表示

このトピックでは、コンパートメント内のすべてのコンテナ・インスタンスをリストする方法と、指定したコンテナ・インスタンスの詳細を表示する方法について説明します。

「コンピュートWeb UI」の使用

  1. ダッシュボードで、「コンテナ / コンテナ・インスタンス」を選択します。

    表示するコンテナ・インスタンスが表示されない場合は、コンテナ・インスタンス・リストの上にある「コンパートメント」ドロップダウン・メニューを使用して、正しいコンパートメントを選択します。

  2. コンテナ・インスタンスの詳細を表示するには、リストでコンテナ・インスタンスの名前を選択します。

    コンテナ・インスタンスの詳細ページが表示されます。

  3. コンテナ・インスタンスの詳細ページで、「リソース」セクションまでスクロールし、「コンテナ」を選択してコンテナ・インスタンス・コンテナに関する情報を表示します。

OCI CLIの使用

  1. 指定されたコンパートメント内のすべてのコンテナ・インスタンスをリストします。

    1. コンテナ・インスタンスをリストするコンパートメントのOCIDを取得: oci iam compartment list

    2. コンテナ・インスタンスのリスト・コマンドを実行します。

      $ oci container-instances container-instance list --compartment-id ocid1.compartment.unique_ID

      --display-nameオプションを追加して、指定した名前のコンテナ・インスタンスのみをリストします。 コンテナ・インスタンス名は一意である必要はありません。

  2. 特定のコンテナ・インスタンスの詳細を取得します。

    1. container-instance listコマンドからコンテナ・インスタンスのOCIDを取得します。

    2. コンテナ・インスタンスの取得コマンドを実行します。

      $ oci container-instances container-instance get --container-instance-id ocid1.container-instance.unique_ID

コンテナ・インスタンスの更新

指定したコンテナ・インスタンスの名前とタグを変更できます。

「コンピュートWeb UI」の使用

  1. ダッシュボードで、「コンテナ / コンテナ・インスタンス」を選択します。

    更新するコンテナ・インスタンスがリストされていない場合は、コンテナ・インスタンス・リストの上にある「コンパートメント」ドロップダウン・メニューを使用して、正しいコンパートメントを選択します。

  2. コンテナ・インスタンス・リストで、更新するコンテナ・インスタンスの「アクション」メニューを選択し、「編集」を選択します。

  3. 変更が完了したら、「Save Changes」ボタンを選択します。

OCI CLIの使用

  1. 更新するコンテナ・インスタンスのOCIDを取得: oci container-instances container-instance list

  2. コンテナ・インスタンスの更新コマンドを実行します。

    例:

    $ oci container-instances container-instance update --container-instance-id ocid1.container-instance.unique_ID \
    --display-name new_name --defined-tags new_tags --force

別のコンパートメントへのコンテナ・インスタンスの移動

このトピックでは、コンテナ・インスタンスを同じテナンシ内の新しいコンパートメントに移動する方法について説明します。 コンテナ・インスタンスを移動するには、OCI CLIを使用する必要があります。

OCI CLIの使用

  1. 移動するコンテナ・インスタンスのOCIDを取得: oci container-instances container-instance list

  2. コンテナ・インスタンスの移動コマンドを実行します。

    例:

    $ oci container-instances container-instance change-compartment --container-instance-id ocid1.container-instance.unique_ID \
    --compartment-id ocid1.compartment.unique_ID

コンテナ・インスタンスの停止、起動および再起動

このトピックでは、コンテナ・インスタンスを起動、停止および再起動する方法について説明します。

非アクティブ状態のコンテナ・インスタンスを起動できます。 アクティブ状態のコンテナ・インスタンスを停止できます。

「コンピュートWeb UI」の使用

  1. ダッシュボードで、「コンテナ / コンテナ・インスタンス」を選択します。

    起動、停止または再起動するコンテナ・インスタンスがリストされていない場合は、コンテナ・インスタンス・リストの上にある「コンパートメント」ドロップダウン・メニューを使用して、正しいコンパートメントを選択します。

  2. 起動、停止または再起動するコンテナ・インスタンスに対して、「アクション」メニューを選択し、「開始」、「停止」または「再起動」オプションを選択します。

    または、コンテナ・インスタンス・リストで、コンテナ・インスタンスの名前を選択して、そのコンテナ・インスタンスの詳細ページを表示します。 「コントロール」メニューを選択し、「開始」、「停止」または「再起動」オプションを選択します。

  3. 確認ダイアログで、「コンテナ・インスタンスの起動」、「コンテナ・インスタンスの停止」または「コンテナ・インスタンスの再起動」ボタンを選択します。

    コンテナ・インスタンスの詳細ページの「リソース」セクションで、「作業リクエスト」を選択して、コンテナ・インスタンスの起動、停止または再起動のステータスを確認します。

OCI CLIの使用

  1. 停止、起動または再起動するコンテナ・インスタンスのOCIDを取得: oci container-instances container-instance list

  2. コンテナ・インスタンスを起動、停止または再起動します。

    • コンテナ・インスタンスが「非アクティブ」の場合は起動します。

      $ oci container-instances container-instance start --container-instance-id ocid1.container-instance.unique_ID
    • コンテナ・インスタンスが「アクティブ」の場合は停止します。

      $ oci container-instances container-instance stop --container-instance-id ocid1.container-instance.unique_ID
    • コンテナ・インスタンスを再起動します。

      $ oci container-instances container-instance restart --container-instance-id ocid1.container-instance.unique_ID

コンテナ・インスタンスの削除

不要になったコンテナ・インスタンスは完全に削除できます。 アタッチされたVNICは、コンテナ・インスタンスが削除されると自動的にデタッチされます。 最終的に、コンテナ・インスタンスのパブリックIPアドレスとプライベートIPアドレスが解放され、他のコンテナ・インスタンスで使用できるようになります。 コンテナがサービスによって削除されると、エフェメラル・ストレージ上のデータが失われます。

「コンピュートWeb UI」の使用

  1. ダッシュボードで、「コンテナ / コンテナ・インスタンス」を選択します。

    削除するコンテナ・インスタンスがリストされていない場合は、コンテナ・インスタンス・リストの上にある「コンパートメント」ドロップダウン・メニューを使用して、正しいコンパートメントを選択します。

  2. 削除するコンテナ・インスタンスに対して、「アクション」メニューをクリックし、「削除」オプションをクリックします。

    または、コンテナ・インスタンス・リストで、コンテナ・インスタンスの名前をクリックして、そのコンテナ・インスタンスの詳細ページを表示します。 「コントロール」メニューをクリックし、「削除」オプションをクリックします。

  3. コンテナ・インスタンスの削除の確認ダイアログで、「確認」ボタンを選択します。

    コンテナ・インスタンス削除のステータスをチェックするには、「リソース」ボックスで「作業リクエスト」を選択します。 削除されたコンテナ・インスタンスは、一時的に「削除済」状態のコンテナ・インスタンスのリストに残ります。

OCI CLIの使用

  1. 削除するコンテナ・インスタンスのOCIDを取得: oci container-instances container-instance list

  2. コンテナ・インスタンスの削除コマンドを実行します。

    $ oci container-instances container-instance delete --container-instance-id ocid1.container-instance.unique_ID

    作業リクエストを表示して、コンテナ・インスタンスの削除のステータスをモニターします。 作業リクエストOCIDは、コンテナ・インスタンスの削除出力で返されます。

    $ oci container-instances work-request get --work-request-id ocid1.workrequest.unique_ID