コードを Code Engine アプリケーション・コンポーネントとして実行するにはどうすればよいですか?

コードがソースとしてローカルファイルや Git リポジトリに存在する場合でも、コードがパブリックまたはプライベートレジストリに存在するコンテナイメージの場合でも、 Code Engine は、コードをアプリとして実行する合理的な方法を提供します。

• Open Container Initiative（OCI）標準に従ってコンテナ・イメージを持っている場合は、アプリを作成してデプロイするときに、コンテナ・レジストリの場所を指すイメージへの参照だけを提供する必要があります。 パブリック・レジストリー または プライベート・レジストリー 内のイメージを使用してアプリをデプロイできます。

• Git リポジトリーにあるソース・コードから開始する場合は、ソースからイメージをビルドし、単一操作でアプリをデプロイする処理を Code Engine に任せることができます。 このシナリオでは、Code Engine はイメージを IBM Cloud® Container Registry にアップロードします。 詳しくは、リポジトリー・ソース・コードからのアプリのデプロイを参照してください。 イメージのビルドをより詳細に制御したい場合は、アプリを作成してデプロイする前に、Code Engine を使用してイメージのビルドを選択できます。

• ローカル・ワークステーションにあるソース・コードから開始する場合は、ソースからのイメージのビルドと単一 CLI コマンドを使用したアプリのデプロイを Code Engine に処理させることができます。 このシナリオでは、Code Engine はイメージを IBM Cloud® Container Registry にアップロードします。 詳しくは、CLI を使用したローカル・ソース・コードからのアプリのデプロイを参照してください。 イメージのビルドをより詳細に制御したい場合は、アプリを作成してデプロイする前に、Code Engine を使用してイメージのビルドを選択できます。

アプリがデプロイされると、アプリの作成方法や以前の更新方法に関係なく、先述の任意の方法でデプロイ済みアプリの更新を行うこともできます。

アプリケーションをデプロイすると、イメージにタグが指定されていない限り、参照されているコンテナー・イメージの最新バージョンがダウンロードされてデプロイされます。 イメージにタグが指定されている場合、タグ付けされたイメージがデプロイメントに使用されます。

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

アプリケーションのデフォルト URL は、 https://<appname>.<uuid>.<region>.codeengine.appdomain.cloud のフォーマットで、 appname はアプリの名前、 uuid は自動的に生成される一意の識別子、 region は Code Engine プロジェクトが存在するリージョンです。 アプリケーションの URL のUUID部分は、 aaaabbbbccc の形式です。 自動的に生成されたアプリケーション URL は、あなたのアプリケーションのプロジェクトのライフサイクルの間、持続します。

地域ごとにアプリケーションにアクセスするためのエンドポイントについて詳しくは、 アプリケーションにアクセスするためのCode Engine エンドポイント を参照してください。

Code Engine内のアプリのポートについて何を知っておく必要がありますか?

デフォルトでは、Code Engine は、アプリが着信接続をポート 8080 で listen することを想定します。 さらに、 Code Engine は、アプリケーションがリッスンすると予想されるポート値を PORT 環境変数に設定する。 アプリがポート 8080 以外のポートをリッスンする必要がある場合は、コンソールからアプリをデプロイして正しいポートを指定するか、コマンドの --port オプションを使用してください。 app create オプションを使ってください。 Code Engine が設定する環境変数について詳しくは、環境変数の自動注入を参照してください。 ポート 8022、 8008、 8012、 9090、 9091、および 15090 は、 Code Engineによって予約されています。 listen ポートとして公開できるポートは 1 つのみです。

インターネット上の HTTP を介した Code Engine へのインバウンド接続は、ポート 80 を使用する。 インターネット上の HTTPS を介した Code Engine へのインバウンド接続では、以下のポートを使用する。 443

ポート・スキャンで表示される開いているポートの数が多い場合は、 ポート・スキャンで予期される数より多くの開いているポートが表示されるのはなぜですか? を参照してください。

HTTP 処理に関する考慮事項

アプリケーション (またはジョブ) を操作する場合は、Code Engineでの基本的な HTTP 処理を認識しておくと役立ちます。

• HTTP を使用する着信アプリケーション接続の場合、トランスポート層セキュリティー (TLS) の側面は、アプリケーション・コードの外部でCode Engineによって自動的に管理されます。 アプリケーションの HTTP サーバーは、HTTPS 接続ではなく HTTP 接続のみを考慮する必要があります。 特に、 Code Engine は、 IBM Cloud の Cloud Internet Services (CIS) を使用している。 は、 CloudFlare, をベースにしており、レイヤー4のDNSとDDOS防御のための侵入防御システム（IPS）として使用されている。 IPSで確立されるTCP/IP接続は、Cloudflareが所有し管理します。 詳しくは、 Cloudflare の資料を参照してください。

• Code Engineアプリケーション用にバインドされたインターネット接続は、HTTPS を使用するように自動的にリダイレクトされます。

• アプリケーションから他の Code Engineアプリケーションへのアウトバウンド接続は、TLS によって自動的に保護されます。Code Engineはこの接続を自動的に管理するため、使用されるプロトコル (または URL) はHTTPであり、HTTPSではありません。

• アプリケーションからCode Engine以外のアプリケーション (インターネットなど) へのアウトバウンド接続では、アプリケーション・コードまたは URL に指定されているプロトコルに応じて、HTTP または HTTPSを使用します。

• バッチ・ジョブからのアウトバウンド接続は、ジョブ・コードまたは URL で指定されたHTTPまたはHTTPSプロトコルを使用します。 この動作には、バッチ・ジョブから Code Engineアプリケーションへの接続が含まれます。

Code Engineアプリケーションの可視性のオプション

Code Engine では、エンドポイント、つまりリクエストを受信するために利用可能なシステム・ドメイン・マッピングを定義することによって、アプリケーションの適切な可視性レベルを決定することができる。

すべてのアプリケーションは、 内部システム・ドメイン・マッピングを持ち、同じ Code Engine プロジェクト内のすべてのコンポーネントから見えるが、プロジェクトの外部からは見えない。 内部システム・ドメイン・マッピングに加えて、 パブリック ・インターネットまたは IBM Cloud プライベート ・ネットワークのいずれかに対してアプリケーションを可視にすることを選択します。

公開または非公開の可視性のために、アプリケーションは HTTPS エンドポイントで公開される。 使用されるTLS証明書の詳細については、 Code Engine プロジェクトのTLS証明 書を参照してください。

以下の可視性レベルでアプリケーションをデプロイできます：

アプリケーションの可視性のエンドポイント設定は、アプリの作成およびデプロイ時または更新時にコンソールからまたは CLI を使用して設定できます。

Code Engine アプリケーションのデプロイについてのオプション

アプリをデプロイするときに指定できる、オプションについて説明します。 なお、コンソールと CLI でオプションが異なる場合があります。

ibmcloud ce app create --name myapp --image icr.io/codeengine/hello --cmd /myapp --arg --debug

アプリケーション割り当て量に関する考慮事項

アプリケーション、関数、およびバッチ・ジョブを処理する場合、これらのリソースは Code Engine プロジェクトのコンテキスト内で実行されます。 リソース割り当て量はプロジェクトごとに定義され、制限はアプリケーション、機能、およびバッチ・ジョブに適用されます。

Code Engine の制限について詳しくは、Code Engine の制限と割り当て量を参照してください。

次のステップ

Code Engine アプリケーションを操作する際の主要な概念を理解したので、アプリケーションをデプロイして操作する準備はできていますか? 詳細については

• パブリック・レジストリー内のイメージからアプリ・ワークロードをデプロイする。
• IBM Cloud Container Registry内のイメージからアプリ・ワークロードをデプロイします。
• プライベート・レジストリー内のイメージからアプリ・ワークロードをデプロイする。
• リポジトリのソースコードからアプリをデプロイする。
• ローカル・ソース・コードからアプリをデプロイする。

アプリでの作業についての詳細は、以下を参照してください

• アプリケーション・ワークロード。
• アプリケーション・スケーリングの構成。
• アプリのカスタム・ドメイン・マッピングを構成します。
• IBM Cloud サービスとサービス・バインディングとの統合。
• 環境変数、 configmaps、および secrets の操作。
• イベント・プロデューサーのサブスクライブ。
• アプリのトラブルシューティングを行います。