Code Engine プロジェクト、アプリケーション、ジョブ、ファンクション、フリートとは何か？

まずは、Code Engine のいくつかの重要な用語について理解してください。

用語について詳しくは、Code Engine の用語を参照してください。

何を選んだらいいかわからない？ Code Engine の計画を参照してください。

アプリ、仕事、機能、フリートの比較は？

詳細は 計画 Code Engine を参照。

最初の Code Engine アプリのデプロイ

icr.io/codeengine/helloworldイメージを使用して、最初のCode Engineアプリを作成します。

1. コンソールを開く Code Engine コンソールを開く。
2. 作成開始を選択します。
3. 選択可能なプロジェクトのリストからプロジェクトを選択します。 新規作成することもできます。 アプリをデプロイするには、選択したプロジェクトがなければならないことに注意してください。
4. **「アプリケーション」**を選択します。
5. アプリケーションの名前を入力してください。例： myapp。 プロジェクト内で固有のアプリケーション名を使用してください。
6. 「 既存のコンテナイメージを使用する 」を選択し、イメージ参照として「 icr.io/codeengine/helloworld 」を指定します。 この例では、デフォルト値を変更する必要はない。 この例で使用されているコードの詳細については、以下を参照してください。 helloworld.
7. 「作成」 をクリックします。
8. アプリケーションの状況が**「準備完了 (Ready)」**に変わったら、アプリケーションをテストできます。 **「アプリケーションのテスト (Test application)」をクリックしてから、「アプリケーションのテスト (Test application)」ペインで「要求の送信」をクリックします。 Web ページでアプリケーションを開くには、「アプリケーション URL (Application URL)」**をクリックします。

出力例

Hello World from:
. ___  __  ____  ____
./ __)/  \(    \(  __)
( (__(  O )) D ( ) _)
.\___)\__/(____/(____)
.____  __ _   ___  __  __ _  ____
(  __)(  ( \ / __)(  )(  ( \(  __)
.) _) /    /( (_ \ )( /    / ) _)
(____)\_)__) \___/(__)\_)__)(____)
Some Env Vars:
--------------
CE_API_BASE_URL=https://api.private.us-south.codeengine.cloud.ibm.com
CE_APP=myapp
CE_DOMAIN=us-south.codeengine.appdomain.cloud
CE_PROJECT_ID=abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
CE_REGION=us-south
CE_SUBDOMAIN=abcdabcdab
HOME=/root
HOSTNAME=myapp-00001-deployment-5b5895fdf7-abcd
K_REVISION=myapp-00001
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
PORT=8080
PWD=/
SHLVL=1
z=Set env var 'SHOW' to see all variables

最初のアプリケーションを Code Engine にデプロイしてテストすることができました。 チュートリアルアプリケーションのデプロイ 、または でアプリを操作する Code Engine 、アプリケーションのオプションをもっと試してみる。

最初の Code Engine ジョブの実行

icr.io/codeengine/helloworldイメージを使用して、最初のCode Engineジョブを作成して実行します。

1. コンソールを開く Code Engine コンソールを開く。
2. 作成開始を選択します。
3. 選択可能なプロジェクトのリストからプロジェクトを選択します。 新規作成することもできます。 ジョブを作成するには、選択したプロジェクトがなければならないことに注意してください。
4. **「ジョブ」**を選択します。
5. ジョブの名前を入力してください。例： myjob。 ジョブには、プロジェクト内で固有の名前を使用します。
6. イメージ参照にicr.io/codeengine/helloworldを指定します。 この例では、デフォルト値を変更する必要はない。 この例で使用されているコードの詳細については、以下を参照してください。 helloworld.
7. 「作成」 をクリックします。
8. ジョブ・ページで、ジョブの実行依頼をクリックして、現在の構成に基づいてジョブを実行依頼します。
9. 「ジョブの実行依頼」ペインで、すべてのデフォルト値を受け入れ、ジョブの実行依頼を再度クリックしてジョブを実行します。

ロギングを有効にすると、以下の例がログに表示される。 ロギングを有効にしてジョブを実行する方法については、ログの表示を参照してください。

ロギング・インスタンスの出力例

Hello World from:
. ___  __  ____  ____
./ __)/  \(    \(  __)
( (__(  O )) D ( ) _)
.\___)\__/(____/(____)
.____  __ _   ___  __  __ _  ____
(  __)(  ( \ / __)(  )(  ( \(  __)
.) _) /    /( (_ \ )( /    / ) _)
(____)\_)__) \___/(__)\_)__)(____)
Some Env Vars:
--------------
CE_DOMAIN=us-east.codeengine.appdomain.cloud
CE_JOB=myjob
CE_JOBRUN=myjob-jobrun-xgpmz
CE_SUBDOMAIN=abcdabcdab
HOME=/root
HOSTNAME=myjob-jobrun-abcde-0-0
JOB_INDEX=0
...
z=Set env var 'SHOW' to see all variables

コンソールからジョブを作成して実行しました。 チュートリアル: ジョブの実行またはCode Engine でのジョブの実行に移動して、ジョブの他のオプションを試してみてください。

最初の関数を実行する

サンプル・ファンクション・コードを使用して、最初の Code Engine ファンクションを作成し、実行します。

1. コンソールを開く Code Engine コンソールを開く。
2. 作成開始を選択します。
3. 選択可能なプロジェクトのリストからプロジェクトを選択します。 新規作成することもできます。 関数を作成するには、プロジェクトが選択されている必要がありますのでご注意ください。
4. 「 機能 」を選択してください。
5. 関数の名前を入力してください。 関数名には、プロジェクト内で一意のものを使用してください。
6. 「 Node.js 」の22 を選択してください
7. 「作成」 をクリックします。 サンプルコードで関数を作成します。 このコードは Function -> Configuration ページで編集できます。
8. [関数のテスト ] をクリックし、[関数のテスト] ペインで [ リクエストを送信 ] をクリックします。 Webページでこの関数を開くには、「 Function URL 」をクリックしてください。

出力例

{
  "args": {
    "__ce_headers": {
      "Accept-Encoding": "gzip, deflate, br",
      "User-Agent": "got (https://github.com/sindresorhus/got)",
      "X-Request-Id": "12340a7b-11c0-4de3-f16b-a6abc27f4146"
    },
    "__ce_method": "GET",
    "__ce_path": "/"
  },
  "env": {
    "HOME": "/root",
    "PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/lib/nodejs/bin",
    "PWD": "/nodejsAction",
    "SHLVL": "1",
    "_": "/usr/local/lib/nodejs/bin/node",
    "__OW_ALLOW_CONCURRENT": "true",
    "container": "oci"
  }
}

Code Engine に最初の関数をデプロイし、テストを行いました。 ローカル・ソースから関数を実行する 」または「 関数で作業する 」で、関数のその他のオプションをお試しください。

最初のフリート

icr.io/codeengine/helloworld イメージを使用して、初めての Code Engine フリートを作成し、実行してください。

1. フリート運営に 必要な準備ステップが 完了していることを確認してください。
2. コンソールを開く Code Engine コンソールを開く。
3. 作成開始を選択します。
4. 選択可能なプロジェクトのリストからプロジェクトを選択します。 新規作成することもできます。 フリートを実行するには、プロジェクトが選択されている必要がありますのでご注意ください。
5. フリート選択
6. 艦隊の名前を入力してください。 プロジェクト内のすべてのフリートで一意となる名前を使用してください。
7. イメージ参照にicr.io/codeengine/helloworldを指定します。 この例では、デフォルト値を変更する必要はない。 この例で使用されているコードの詳細については、以下を参照してください。 helloworld.
8. 「作成」をクリックします。

ロギングを有効にすると、以下の例がログに表示される。 ロギングを有効にしたフリート実行については、 フリートログの表示を 参照してください。

ロギング・インスタンスの出力例

Hello from helloworld! I'm a task of fleet: fleet-abcdef1234! Task Index: 4, Task ID: 2b2b2b2b-3c3c-4d4d-5e5e-6f6f6f6f6f6f
Hello World from:
. ___  __  ____  ____
./ __)/  \(    \(  __)
( (__(  O )) D ( ) _)
.\___)\__/(____/(____)
.____  __ _   ___  __  __ _  ____
(  __)(  ( \ / __)(  )(  ( \(  __)
.) _) /    /( (_ \ )( /    / ) _)
(____)\_)__) \___/(__)\_)__)(____)
Some Env Vars:
--------------
CE_API_BASE_URL=https://api.private.eu-de.codeengine.cloud.ibm.com
CE_CPU=1
CE_DOMAIN=eu-de.codeengine.appdomain.cloud
CE_FLEET_ID=1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e
CE_FLEET_NAME=fleet-abcdef1234
...
z=Set env var 'SHOW' to see all variables

コンソールから艦隊を作成し、運用しました。 艦隊の運営 、フリートに関するより多くのオプションを試してみる。

ソース・コードからの最初のコンテナー・イメージの作成

最初の Code Engine ビルドを作成して実行してから、そのコンテナー・イメージをアプリケーションにデプロイします。

Code Engine は、ユーザーのアカウントの Container Registry の名前空間にイメージを自動的にプッシュできます。 名前空間を自動で作成することもできます。 イメージを別のContainer Registryアカウントまたはプライベート Docker Hub アカウントにプッシュするには、プライベート・コンテナー・レジストリーへのアクセス権限の追加を参照してください。

1. コンソールを開く Code Engine コンソールを開く。
2. 作成開始を選択します。
3. 選択可能なプロジェクトのリストからプロジェクトを選択します。 新規作成することもできます。 アプリをデプロイするには、選択したプロジェクトがなければならないことに注意してください。
4. **「アプリケーション」**を選択します。
5. アプリケーションの名前を入力します。 プロジェクト内で固有のアプリケーション名を使用してください。
6. 「 ソースコードからコンテナイメージをビルド 」を選択します。
7. **「ビルドの詳細を指定 (Specify build details)」**をクリックします。
8. 各ページのデフォルトを受け入れ、[ Next]、[ Done]の順にクリックする。
9. 「作成」 をクリックします。

ビルド実行が実行されると、ビルドされたコンテナー・イメージが Container Registry に送信され、アプリケーションが自動的にそのイメージをプルしてデプロイします。 アプリケーションの状況が**「準備完了 (Ready)」**に変わったら、それを試行できます。 **「アプリケーションのテスト (Test application)」をクリックしてから、「アプリケーションのテスト (Test application)」ペインで「要求の送信」をクリックします。 Web ページでアプリケーションを開くには、「アプリケーション URL (Application URL)」**をクリックします。

出力例

Hello World from:
     ___  __  ____  ____
    / __)/  \(    \(  __)
   ( (__(  O )) D ( ) _)
    \___)\__/(____/(____)
 ____  __ _   ___  __  __ _  ____
(  __)(  ( \ / __)(  )(  ( \(  __)
 ) _) /    /( (_ \ )( /    / ) _)
(____)\_)__) \___/(__)\_)__)(____)
Some Env Vars:
--------------
CE_API_BASE_URL=https://api.private.us-south.codeengine.cloud.ibm.com
CE_APP=myapp
CE_DOMAIN=us-south.codeengine.appdomain.cloud
CE_PROJECT_ID=abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
CE_REGION=us-south
CE_SUBDOMAIN=abcdabcdab
HOME=/root
HOSTNAME=myapp-00001-deployment-6db6d89dc7-k6qc7
K_REVISION=myapp-00001
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
PORT=8080
PWD=/
SHLVL=1

ソース・コードを Code Engine に送信し、コンテナー・イメージを作成し、アプリケーションにデプロイする、という作業をすべて 1 つのインターフェースから実行しました。

コンテナー・イメージのビルドに移動し、ビルドの他のオプションを調べて試してみてください。

Code Engine の次のステップ

これらの Code Engine タスクを、コンソールまたは Code Engine CLI で実行する方法について確認します。

• プロジェクトの管理
• アプリケーションのデプロイ
• ジョブの実行
• ランニング機能
• コンテナー・イメージのビルド

コード・サンプルがさらに必要ですか? Samples for IBM Cloud Code Engine GitHub repoをチェックしてください。