クラウド・シェルでのファンクション QuickStart

適切なユーザーおよびグループが存在しない場合:

1. テナンシ管理者としてコンソールにサインインします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」をクリックします。「アイデンティティ」で、「グループ」をクリックします。
3. 「グループ」、「グループの作成」の順にクリックして、新しいグループを作成します。
   
4. 「ユーザー」、「ユーザーの作成」の順にクリックして、新しいユーザーを作成します。
   
5. 「グループ」、グループの名前、「ユーザーをグループに追加」の順にクリックして、ユーザーをグループに追加します。
   

詳細は、構成ノートを参照してください。

ネットワーク・リソースを作成する適切なコンパートメントおよびOCIファンクション・リソースがすでに存在しない場合:

1. テナンシ管理者としてコンソールにサインインします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」をクリックします。「アイデンティティ」で、「コンパートメント」をクリックします。
3. 「コンパートメントの作成」をクリックします。
   

詳細は、構成ノートを参照してください。

ネットワーク・リソースを作成する適切なVCNが存在しない場合:

詳細は、構成ノートを参照してください。

1つ以上のOCI Functionsユーザーがテナンシ管理者ではない場合:

1. テナンシ管理者としてコンソールにサインインします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」をクリックします。「アイデンティティ」で、「ポリシー」をクリックします。

3. 「ポリシーの作成」をクリックし、新しいポリシーの名前と説明を指定して、テナンシのルート・コンパートメントを選択します。

4. ポリシー・ビルダーを使用してポリシーを作成します。ポリシー・ユースケースのリストから「ファンクション」を選択し、ポリシー・テンプレートユーザーによるファンクションとアプリケーションの作成、デプロイおよび管理に基づいてポリシーを作成します。

   

   ポリシー・テンプレートには、次のポリシー・文が含まれます:

   • Allow group <group-name> to use cloud-shell in tenancy
   • Allow group <group-name> to manage repos in tenancy
   • Allow group <group-name> to read objectstorage-namespaces in tenancy
   • Allow group <group-name> to manage logging-family in tenancy
   • Allow group <group-name> to read metrics in tenancy
   • Allow group <group-name> to manage functions-family in tenancy
   • Allow group <group-name> to use virtual-network-family in tenancy
   • Allow group <group-name> to use apm-domains in tenancy
   • Allow group <group-name> to read vaults in tenancy
   • Allow group <group-name> to use keys in tenancy
   • Allow service faas to use apm-domains in tenancy
   • Allow service faas to read repos in tenancy where request.operation='ListContainerImageSignatures'
   • Allow service faas to {KEY_READ} in tenancy where request.operation='GetKeyVersion'
   • Allow service faas to {KEY_VERIFY} in tenancy where request.operation='Verify'

   必要に応じて、コンパートメントごとにこれらのポリシー・ステートメントを制限できます。

詳細は、構成ノートを参照してください。

1. ファンクション開発者としてコンソールにサインインします。
2. ナビゲーション・メニューを開き、「開発者サービス」をクリックします「ファンクション」で、「アプリケーション」をクリックします。
3. OCIファンクションで使用するリージョンを選択します。
4. 「アプリケーションの作成」をクリックします。
   
5. 次を指定します:
   • 新規アプリケーションの名前としてのhelloworld-app。このアプリケーションに最初の関数をデプロイし、関数を呼び出すときにこのアプリケーションを指定します。
   • ファンクションを実行するVCNおよびサブネット。パブリック・サブネットにはVCN内のインターネット・ゲートウェイが必要であり、プライベート・サブネットにはVCN内のサービス・ゲートウェイが必要です。
6. 「作成」をクリックします。

詳細は、詳細な手順を参照してください。

コンソールのアプリケーション・ページ:

1. 作成したhelloworld-appアプリケーションをクリックして、アプリケーションの詳細ページを表示します。

2. 「スタート・ガイド」リンクをクリックし、「クラウド・シェル設定」をクリックします。

   

   ヒント: 「スタート・ガイド」ページに、ユーザー専用のコマンドが表示されるようになりました。これらのコマンドをコピーして貼り付け、ファンクション開発用にクラウド・シェル環境を構成します。

3. 「Cloud Shellの起動」をクリックして「Cloud Shell」ターミナル・ウィンドウを表示します。
   

次のように、「スタート・ガイド」ページからクラウド・シェル端末ウィンドウにコマンドをコピーして貼り付け、環境を構成します:

1. アプリケーションを作成した現在のリージョンの事前作成済のFn Projectコンテキストの名前を検索します。

   fn list context

   少なくとも2つのFn Projectコンテキスト、デフォルト・コンテキストおよび現在のリージョンのコンテキスト(us-phoenix-1など)が返されます。

2. リージョン・コンテキストを使用するようにFn Projectコンテキストを設定します。

   fn use context <region-context>

   ここで、<region-context>は現在のリージョンのコンテキストです。例:

   fn use context us-phoenix-1

3. デプロイされた機能を所有する現在のコンパートメントのOCIDを使用してFn Projectコンテキストを構成します:

   fn update context oracle.compartment-id <compartment-ocid>

   例:

   fn update context oracle.compartment-id ocid1.compartment.oc1..aaaaaaaarvdfa72n...

4. OCIファンクションで使用する現在のリージョンおよびテナンシのOracle Cloud Infrastructure Registryアドレスを使用して、Fn Projectコンテキストを構成します:

   fn update context registry <region-key>.ocir.io/<tenancy-namespace>/<repo-name-prefix>

   <repo-name-prefix>は、関数のイメージを格納するOracle Cloud Infrastructure Registryリポジトリ用に選択した接頭辞です。例:

   fn update context registry phx.ocir.io/ansh81vru1zp/acme-repo

5. 次のように入力して、OCIファンクションがファンクション・イメージのプッシュおよびプルするリポジトリのコンパートメントのOCIDを使用してFn Projectコンテキストを構成します:

   fn update context oracle.image-compartment-id <compartment-ocid>

   例:

   fn update context oracle.image-compartment-id ocid1.compartment.oc1..aaaaaaaaquqe______z2q

   oracle.image-compartment-idの値を指定しない場合、OCI関数はルート・コンパートメント内のリポジトリに対してイメージをプッシュおよびプルします。

詳細は、構成ノートを参照してください。

コンソールのスタート・ガイド・ページで:

1. 「認証トークンの生成」をクリックして「認証トークン」ページを表示し、「トークンの生成」をクリックします。
   
2. 「トークンの生成」ダイアログで認証トークンのわかりやすい説明を入力し、「トークンの生成」をクリックします。新しい認証トークンが表示されます(たとえば、6aN...6MqX)。
3. 認証トークンを、後で取得できる保護された場所にただちにコピーします。これは、コンソールに認証トークンが再度表示されないようにするためです。
4. 「トークンの生成」ダイアログを閉じます。

詳細は、構成ノートを参照してください。

コンソールのスタート・ガイド・ページで:

1. 次のコマンドをコピーします。

   docker login -u '<tenancy-namespace>/<user-name>' <region-key>.ocir.io

   例:

   docker login -u 'ansh81vru1zp/jdoe@acme.com' phx.ocir.io

   テナンシがOracle Identity Cloud Serviceとフェデレートされている場合、フォーマットは少し異なります。例:

   docker login -u 'ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com' phx.ocir.io

2. ターミナル・ウィンドウで、コピーしたコマンドを貼り付けて実行します。

3. パスワードのプロンプトが表示されたら、以前に作成およびコピーしたOracle Cloud Infrastructure認証トークンを入力します。例: 6aN...6MqX

   これで、ファンクションの作成、デプロイおよび呼出しを開始する準備ができました。

詳細は、構成ノートを参照してください。

端末ウィンドウで:

1. 次を入力してhelloworld javaファンクションを作成します。

   fn init --runtime java hello-java

   hello-javaというディレクトリが作成され、次のものが含まれます。

   • func.yamlという関数定義ファイル
   • helloworld関数のソース・ファイルおよびディレクトリを含む/srcディレクトリ
   • pom.xmlというMaven構成ファイル。関数のコンパイルに必要な依存性を指定します。

   Javaは、サポートされている複数の言語の1つです。

   詳細は、詳細な手順を参照してください。

端末ウィンドウで:

1. 前の手順で作成したhello-javaディレクトリにディレクトリを変更します。

   cd hello-java

2. 次の単一のFn Projectコマンドを入力して、ファンクションおよびその依存関係をhello- javaというDockerイメージとして作成し、そのイメージを指定したDockerレジストリにプッシュして、以前に作成したhelloworld- appアプリケーションのOCIファンクションにファンクションをデプロイします。

   fn -v deploy --app helloworld-app

3. (オプション)helloworld- appアプリケーションの詳細ページの「リソース」の下にある「関数」をクリックし、hello- java関数が表示されるようにして、関数がOCI関数にデプロイされていることを確認します。

詳細は、詳細な手順を参照してください。

端末ウィンドウで:

1. 次を入力してhello-java関数を起動します。

   fn invoke helloworld-app hello-java

   「Hello world!」メッセージが表示されます。

2. 次のように入力して、パラメータ'John'でhello-java関数を起動します。

   echo -n 'John' | fn invoke helloworld-app hello-java

   'Hello John!'メッセージが表示されます。

完了しました。OCIファンクションを使用して最初のファンクションを作成、デプロイおよび起動しました。

詳細は、詳細な手順を参照してください。

ファンクションを作成、デプロイおよび起動したので、次の方法を学習します。

• Oracle Cloud Infrastructure Loggingサービス、またはsyslog URLの構成によるファンクション・ログの表示(ファンクション・ログの格納および表示を参照)
• GitHubのサンプルを使用してOCIファンクションを確認します(Oracle Functionsのサンプルを参照)
• SDKを使用したファンクションの起動(SDKを使用したファンクションの起動を参照)

これで完了です。