アプリの更新

構成設定を変更せずにアプリケーションを再デプロイする場合はどうすればよいですか?

構成値を変更し、アプリケーションをデプロイすることにより、構成変更を使用していつでもアプリケーションをデプロイできます。

ただし、アプリケーション構成設定を変更せずにアプリケーション・リビジョンを再デプロイすることもできます。 参照されているコンテナー・イメージが変更され、更新されたコンテナー・イメージをアプリケーション・リビジョンで使用する必要がある場合があります。 あるいは、更新されたコンテンツ値を含むシークレットまたは構成マップをアプリケーションで参照することもできます。

このようなシナリオでは、アプリケーションの構成を変更せずに、コンソールからアプリケーション・ページの 「構成」 タブの 「再デプロイ」 をクリックできます。 CLI で、 ibmcloud ce app update コマンドを使用します。

コンソールでのアプリの更新

コンソールでのパブリック・レジストリーからのアプリケーションのデプロイで作成したアプリケーションを更新して、環境変数を追加します。

1. アプリケーション・ページにナビゲートします。 アプリケーション・ページにナビゲートする方法の 1 つは、以下のとおりです。
   • Code Engine プロジェクト・ページを見つけます。
   • プロジェクト名をクリックすると、概要ページが開きます。
   • **「アプリケーション」**をクリックして、アプリケーションのリストを開きます。 アプリケーションの名前をクリックして、そのアプリケーション・ページを開きます。
2. アプリケーション・ページから、アプリケーションの実行中のインスタンスとそのリビジョン、構成の詳細、およびアプリケーションのエンドポイント設定に関する情報を表示できます。 処理するアプリケーション・リビジョンの名前をクリックして、そのリビジョンの構成サマリーを開きます。 または、**「構成」**タブをクリックして、最新のアプリケーション・リビジョンの構成サマリーを開くこともできます。
3. 「構成」 タブで、 「環境変数」 タブをクリックします。
4. **「環境変数の追加 (Add environment variable)」**をクリックします。 この環境変数をリテラル値として定義します。 名前に TARGET、値に Stranger を入力します。 **「追加」**をクリックします。
5. Deploy をクリックして変更を保存し、アプリケーションリビジョンをデプロイします。
6. アプリケーションの状況が**「準備完了 (Ready)」**に変わったら、アプリケーションのリビジョンをテストできます。 **「アプリケーションのテスト (Test application)」をクリックしてから、「アプリケーションのテスト (Test application)」ペインで「要求の送信」をクリックします。 Web ページでアプリケーションを開くには、「アプリケーション URL (Application URL)」**をクリックします。 このアプリでは、Hello Strangerが表示されます。

この例では、アプリの環境変数を更新しました。 「コード」タブで、別のイメージや別のイメージ・ビルドを参照するなど、アプリのその他の構成設定を更新することもできます。 「リソース」&「スケーリング」 タブから、アプリの メモリー および アプリケーション・スケーリング 設定を更新できます。 **「環境変数」**タブで、アプリの環境変数を追加または更新できます。 「イメージ開始オプション (Image start options)」 タブで、 コマンドおよび引数 を追加または更新してコンテナー・イメージ内の設定をオーバーライドしたり、 活性プローブおよび作動可能プローブの処理 を行ったりすることができます。

コンソールからプロジェクト専用エンドポイントを使用するためのアプリの更新

デフォルトでは、アプリをデプロイすると、アプリは、パブリック・インターネット、プライベート・ネットワーク、またはプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 このアプリケーションの可視性を変更して、同じ Code Engine 環境で実行されている他の Code Engine リソースからのみアクセスされるようにしましょう。 Domain mappings（ドメインマッピング） タブを使用して、アプリの可視性を変更します。

1. アプリケーション・ページにナビゲートします。 アプリケーション・ページにナビゲートする方法の 1 つは、以下のとおりです。

   • Code Engine プロジェクト・ページを見つけます。
   • プロジェクト名をクリックすると、概要ページが開きます。
   • **「アプリケーション」**をクリックして、アプリケーションのリストを開きます。 アプリケーションの名前をクリックして、そのアプリケーション・ページを開きます。

2. アプリケーション・ページから、アプリケーションの実行中のインスタンスとそのリビジョン、構成の詳細、およびアプリケーションのエンドポイント設定に関する情報を表示できます。 ドメインマッピング］ タブをクリックして、アプリケーションのエンドポイント可視性設定を開きます。

3. Domain mappings（ドメインマッピング） タブで、アプリケーションで利用可能なURLを確認します。 Public を選択すると、アプリケーションのパブリック・システム・ドメインと内部システム・ドメインのマッピング URL を表示できます。 No external system domain mapping（外部システムドメインマッピングなし ）」を選択すると、このアプリケーションはパブリックインターネットからアクセスできなくなり、このプロジェクト内のコンポーネントからのみネットワークアクセスが可能になります。

   アプリの可視性を変更すると、変更は即座に有効になります。 アクティブ・ユーザーまたは統合に対する変更の影響と、セキュリティーへの影響を考慮することが重要です。 可視性の設定は、必要に応じて変更できます。

コンソールからプライベート・エンドポイントを使用するためのアプリの更新

デフォルトでは、アプリをデプロイすると、アプリは、パブリック・インターネット、プライベート・ネットワーク、またはプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 このアプリの可視性を変更して、同じプロジェクトで実行されている他のCode Engineリソースと、仮想プライベート・エンドポイントを使用してプライベート・ネットワークからのみアクセスされるようにしましょう。 Domain mappings（ドメインマッピング） タブを使用して、アプリの可視性を変更します。

1. アプリケーション・ページにナビゲートします。 アプリケーション・ページにナビゲートする方法の 1 つは、以下のとおりです。

   • Code Engine プロジェクト・ページを見つけます。
   • プロジェクト名をクリックすると、概要ページが開きます。
   • **「アプリケーション」**をクリックして、アプリケーションのリストを開きます。 アプリケーションの名前をクリックして、そのアプリケーション・ページを開きます。

2. アプリケーション・ページから、アプリケーションの実行中のインスタンスとそのリビジョン、構成の詳細、およびアプリケーションのエンドポイント設定に関する情報を表示できます。 ドメインマッピング］ タブをクリックして、アプリケーションのエンドポイント可視性設定を開きます。

3. Domain mappings（ドメインマッピング） タブで、アプリケーションで利用可能なURLを確認します。 Privateを選択すると、このアプリケーションはもうパブリック・インターネットからアクセスできなくなり、このプロジェクト内のコンポーネント (クラスター・ローカル) およびプライベート・ネットワークからのみネットワーク・アクセスが可能になります。

   私用をクリックして、アプリのエンドポイントの可視性を変更します。 エンドポイント定義で使用可能な URL は、プライベート URL とプロジェクト専用 URL に対して表示されます。

4. 仮想プライベート・エンドポイント (VPE) を使用してアプリに安全にアクセスするには、VPE を使用したアプリへのアクセスの手順に従って、アプリにアクセスするように VPE をセットアップします。

visibility = private用にアプリケーションを設定した場合は、仮想プライベート・クラウド (VPC) 内からの仮想プライベート・エンドポイントを介してのみアプリケーションをテストできます。

アプリの可視性を変更することで、変更は即時に有効になります。 アクティブ・ユーザーまたは統合に対する変更の影響と、セキュリティーへの影響を考慮することが重要です。 可視性の設定は、必要に応じて変更できます。

CLI でのアプリの更新

CLI でアプリを更新するには、app update コマンドを使用します。 このコマンドには更新するアプリの名前が必要で、その他のオプションの引数も使用できます。 オプションの全リストについては、ibmcloud ce app update コマンドを参照してください。

CLI でアプリケーションをデプロイするで作成したアプリケーションの更新によって、環境変数を追加します。

サンプルのicr.io/codeengine/helloイメージは、環境変数TARGETを読み取り、Hello ${TARGET}を出力します。 この環境変数が空の場合は、Hello World が返されます。 次の例は、アプリを更新し、TARGET 環境変数の値を Stranger に変更します。 この例で使用されるコードについて詳しくは、 helloを参照してください。

1. application update コマンドを実行します。 以下に例を示します。

   ibmcloud ce application update -n myapp --env TARGET=Stranger
   

   出力例

   Updating application 'myapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myapp' to check the application status.
   OK
   
   https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud    
   

2. application get コマンドを実行して、最新リビジョンの情報を含む、アプリの状況を表示します。

   ibmcloud ce application get --name myapp  
   

   出力例

   [...]
   Name:          myapp
   [...]
   URL:           https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   **「Revisions」**セクションの出力から、myapp サービスのアプリケーションの最新リビジョンを確認できます。 また、アプリケーションへのトラフィックの 100% が、アプリの最新リビジョンを実行していることにも注目してください。

3. アプリケーションを呼び出します。

   curl https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud
   

   出力例

   Hello Stranger
   

   このコマンドの出力で、更新されたアプリによって Hello Stranger が返されることを確認できます。

4. ibmcloud ce revision listコマンドを使用して、すべてのアプリ・リビジョンを表示します。 Code Engine では、プロジェクト内のアプリ・リビジョン数の割り当て量が設定されているため、この情報を使用してアプリのリビジョンを管理できます。

   次の revision list の出力で、Code Engine がアクティブなアプリケーションのリビジョンの他に保持するのが、アクティブでない最新のアプリ・リビジョンだけであることに注目してください。 古いリビジョンは削除されます。

   ibmcloud ce revision list
   

   出力例

   Listing all application revisions...
   OK
   
   Name                   Application      Status  URL  Latest  Tag  Traffic  Age    Conditions  Reason
   myapp-hc3u8-4           myapp            Ready                            2d15h    3 OK / 4
   myapp-hc3u8-5           myapp            Ready        true         100%    2d8h    3 OK / 4  
   myapp2-vjfqt-1          myapp2           Ready        true         100%      3d    3 OK / 4
   myhelloapp-tv368-3      myhelloapp       Ready                              16d    3 OK / 4
   myhelloapp-tv368-4      myhelloapp       Ready        true         100%     16d    3 OK / 4
   newapp-mytest-00008     newapp-mytest    Ready                              4d17h  3 OK / 4
   newapp-mytest-00009     newapp-mytest    Ready        true         100%     2d20h  3 OK / 4
   

アプリのリビジョンを管理するには、ibmcloud ce revision get コマンドを使用してアプリのリビジョンの詳細を表示し、ibmcloud ce revision delete コマンドを使用して、保持しないリビジョンを削除します。 また、ibmcloud ce revision logs コマンドを使用して、アプリケーション・リビジョン・インスタンスのログを表示することもできます。 ibmcloud ce revision events コマンドを使用すると、アプリケーション・リビジョン・インスタンスのシステム・イベントを表示できます。

CLI でプロジェクト専用エンドポイントを使用するためのアプリの更新

デフォルトでは、アプリをデプロイすると、アプリは、パブリック・インターネット、プライベート・ネットワーク、またはプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 同じプロジェクトで実行されている他の Code Engine リソースからのみアクセスされるようにアプリの可視性を変更するには、 ibmcloud ce app update または ibmcloud ce app create コマンドで --visibility=project オプションを使用します。

このシナリオでは、CLI を使用したアプリケーションのデプロイで作成したアプリケーションを更新して、プロジェクト・エンドポイントを使用するようにアプリの可視性を変更します。

1. application update コマンドを実行します。 以下に例を示します。

   ibmcloud ce application update -n myapp --visibility=project
   

   出力例

   Updating application 'myapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myapp' to check the application status.
   OK
   
   http://myapp.4svg40kna19.svc.cluster.local   
   

2. application get コマンドを実行して、最新リビジョンの情報を含む、アプリの状況を表示します。

   ibmcloud ce application get --name myapp  
   

   出力例

   [...]
   Name:          myapp
   [...]
   URL:           http://myapp.4svg40kna19.svc.cluster.local
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   **「Revisions」**セクションの出力から、myapp サービスのアプリケーションの最新リビジョンを確認できます。 また、アプリケーションへのトラフィックの 100% が、アプリの最新リビジョンを実行していることにも注目してください。

アプリケーションで --visibility=project を設定すると、このアプリケーションはパブリック・インターネットからアクセスできなくなり、このプロジェクト内のコンポーネント (クラスター・ローカル) からのみネットワーク・アクセスが可能になります。

CLI でプライベート・エンドポイントを使用するためのアプリの更新

デフォルトでは、アプリをデプロイすると、アプリは、パブリック・インターネット、プライベート・ネットワーク、またはプロジェクト内のコンポーネントから要求を受信できるようにデプロイされます。 プライベート・エンドポイントを使用してデプロイされるように、アプリのエンドポイント可視性を設定できます。 プライベート・エンドポイントを設定すると、パブリック・インターネットからアプリにアクセスできなくなり、同じプロジェクト (クラスター・ローカル) で実行されている仮想プライベート・エンドポイント (VPC) またはCode Engineコンポーネントの他のIBM Cloudサービスからのみネットワーク・アクセスが可能になります。

プライベート・エンドポイントでのみアクセスされるようにアプリの可視性を変更するには、 ibmcloud ce app update または ibmcloud ce app create コマンドで --visibility=private オプションを使用します。

選択したプロジェクトが アプリケーションのプライベート可視性をサポートしている場合は、プライベート・エンドポイントを使用してアプリにアクセスするためにのみ VPE を使用できます。 プロジェクトがアプリケーションのプライベート可視性をサポートしているかどうかを確認するには、ibmcloud ce project getコマンドを使用して、Application Private Visibility Supportedの出力がtrueに設定されていることを確認します。

このシナリオでは、CLI を使用したアプリケーションのデプロイで作成したアプリケーションを更新して、プライベート・エンドポイントを使用するようにアプリの可視性を変更します。

1. 既存のプロジェクトが、プライベート可視性を持つアプリケーションをサポートしていることを確認します。 ibmcloud ce project getコマンドを使用して、Application Private Visibility Supportedの出力がtrueに設定されていることを確認します。 値がfalseの場合、IBM サポートへの連絡は、既存のプロジェクト内でこの機能を有効にします。

   ibmcloud ce project get -n myproject
   

   出力例

   Getting project 'myproject'...
   OK
   
   Name:                                      myproject  
   ID:                         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
   Status:                                    active  
   Enabled:                                   true  
   Application Private Visibility Supported:  true  
   Selected:                                  true  
   Region:                                    us-south
   Resource Group:             default
   Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
   Age:                        52d
   Created:                                   Tue, 28 Sep 2021 05:12:16 -0500  
   Updated:                                   Tue, 28 Sep 2021 05:12:19 -0500  
   
   Quotas:    
   Category                                  Used  Limit  
   App revisions                             1     60  
   Apps                                      1     20  
   Build runs                                1     100  
   Builds                                    2     100  
   Configmaps                                2     100  
   CPU                                       0     64  
   Ephemeral storage                         0     256G  
   Instances (active)                        0     250  
   Instances (total)                         0     2500  
   Job runs                                  0     100  
   Jobs                                      0     100  
   Memory                                    0     256G  
   Secrets                                   6     100  
   Subscriptions (cron)                      0     100  
   Subscriptions (IBM Cloud Object Storage)  0     100  
   Subscriptions (Kafka)                     0     100
   

2. Application Private Visibility Supportedがtrueの場合は、プライベート・エンドポイントを使用するようにアプリを更新できます。 application update コマンドを実行します。 以下に例を示します。

   ibmcloud ce application update -n myapp --visibility=private
   

   出力例

   Updating application 'myapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myapp' to check the application status.
   OK
   
   https://myapp.4svg40kna19.private.us-south.codeengine.appdomain.cloud
   

3. application get コマンドを実行して、最新リビジョンの情報を含む、アプリの状況を表示します。

   ibmcloud ce application get --name myapp  
   

   出力例

   [...]
   Name:          myapp
   [...]
   URL:           https://myapp.4svg40kna19.private.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   **「Revisions」**セクションの出力から、myapp サービスのアプリケーションの最新リビジョンを確認できます。 また、アプリケーションへのトラフィックの 100% が、アプリの最新リビジョンを実行していることにも注目してください。

4. VPE をライベート・エンドポイントを使用してアプリにアクセスするようにセットアップします。

別のイメージを参照するためのアプリの更新

別のイメージを参照するようにアプリを更新できます。

特定のアプリケーション・リビジョンに関連付けられているイメージには固有のコンテナー・レジストリー・ダイジェストがあり、 Code Engine は、アプリケーション・リビジョンの存続期間中、このダイジェストを使用します。 元のイメージと同じタグを持つ新しいバージョンのイメージを作成すると、元のイメージはコンテナー・レジストリー内で上書きされ、タグが解除されます。 新しいイメージにはタグが付けられ、この新しいイメージには別のダイジェストがあります。 Code Engine アプリケーションは、この新しいイメージを使用しません。新しいイメージのダイジェストは、アプリケーション・リビジョンによって参照されるイメージのダイジェストとは異なるためです。 Code Engine は、元々参照されていたタグなしイメージがまだ存在している限り、アプリケーション・リビジョンの新規インスタンスを作成できます。 詳しくは、 イメージを Code Engine プルできないのはなぜですか? を参照してください。