OCIコンピュート・インスタンスでのファンクションのクイックスタート

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

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

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

ネットワーク・リソースおよびOCI Functionsリソースを作成する適切なコンパートメントがまだ存在しない場合:

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 Functionsで使用しているリージョンを選択します。
4. 「アプリケーションの作成」をクリックします。
   
5. 次を指定します:
   • 新規アプリケーションの名前としてhelloworld-app。このアプリケーションに最初のファンクションをデプロイし、ファンクションの起動時にこのアプリケーションを指定します。
   • ファンクションを実行するVCNおよびサブネット。パブリック・サブネットにはVCN内のインターネット・ゲートウェイが必要で、プライベート・サブネットにはVCN内のサービス・ゲートウェイが必要です。
6. 「作成」をクリックします。

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

1. テナンシ管理者としてコンソールにサインインします。
2. ナビゲーション・メニューを開き、「コンピュート」をクリックします。「コンピュート」で、「インスタンス」をクリックします。
3. ネットワーク・リソースおよびOCI Functionsリソースを作成するコンパートメントを選択します。
4. 適切なコンピュート・インスタンスがコンパートメントにまだ存在しない場合は、「インスタンスの作成」をクリックして次を実行します:
   • OCI関数で使用するコンパートメント、VCNおよびサブネットを選択します
   • パブリックIPアドレスを新しいコンピュート・インスタンスに割り当てるように指定します
   • 新しいコンピュート・インスタンスにアクセスするためのSSHキーを含むファイルを選択します

5. 「インスタンスの詳細」ページで、開発環境として使用するコンピュート・インスタンスのOCIDおよびパブリックIPアドレスをコピーします。

詳細は、インスタンスの作成を参照してください。

コンピュート・インスタンスを含める新しい動的グループを作成します:

1. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」をクリックします。「アイデンティティ」で、「ドメイン」をクリックします。「アイデンティティ・ドメイン」で、「動的グループ」をクリックします。
2. 新規動的グループを作成します。

3. コンピュート・インスタンスのOCIDを含むルールを入力します:

   ANY {instance.id = '<instance-ocid>'}

詳細は、動的グループの管理を参照してください。

ファンクション・リソース、ネットワーク・リソースおよびOracle Cloud Infrastructure Registryへの新しい動的グループ・アクセスを提供するポリシーを作成する:

1. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」をクリックします。「アイデンティティ」で、「ポリシー」をクリックします。

2. 「ポリシーの作成」をクリックし、ポリシー・ビルダーのマニュアル・エディタを使用して、次のポリシー文を使用して新しいポリシーを作成します:

   • Allow dynamic-group <dynamic-group-name> to manage functions-family in compartment <compartment-name>
   • Allow dynamic-group <dynamic-group-name> to use virtual-network-family in compartment <compartment-name>
   • Allow dynamic-group <dynamic-group-name> to read repos in tenancy

詳細は、ポリシーの管理を参照してください。

開発環境のターミナル・ウィンドウ:

1. 次のように入力して、Dockerがインストールされていることを確認します:

   docker version

   Dockerがインストールされていないことを示すエラー・メッセージが表示された場合は、続行する前にDockerをインストールする必要があります。ご使用のプラットフォームのDockerドキュメントを参照してください(Oracle Linuxについては、こちらを参照してください)。

   Dockerがインストールされている場合、GitHubのFn Projectホームページの「前提条件」セクションに移動し、インストールされているDockerのバージョンが少なくともそこで指定されている最小バージョンであることを確認します。そうでない場合は、続行する前にDockerを再インストールしてください。

2. 次のように入力して、標準のhello-world Dockerイメージをコンテナとして起動し、Dockerが実行されていることを確認します:

   docker run hello-world

   Dockerが実行されていないことを示すエラー・メッセージが表示された場合は、続行する前にDockerデーモンを起動する必要があります。Dockerドキュメントを参照してください。

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

開発環境のターミナル・ウィンドウ:

1. ご使用の環境にあわせて、次の適切な手順を使用してFn ProjectのCLIをインストールします。
   • LinuxまたはMacOS: 次のように入力します。

     curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh

   • Homebrewを使用したMacOS: Enter:

     brew update && brew install fn

   • Windows: GitHubへのFnクライアントのインストール手順に従います。
   • Linux、MacOSまたはWindows: 「Fn Project Releases」ページ(GitHub)からバイナリをダウンロードして実行します。
2. 次のように入力して、Fn ProjectのCLIがインストールされていることを確認します:

   fn version

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

開発環境のターミナル・ウィンドウ:

1. 次を入力して、新しいFn ProjectのCLIコンテキストを作成します:

   fn create context <my-context> --provider oracle-ip

   --provider oracle-ipを指定すると、インスタンスOCIDs、動的グループおよびそれらの動的グループに権限を付与するポリシーを使用した認証および認可が有効になります。

2. 次を入力して、Fn ProjectのCLIが新しいコンテキストを使用するように指定します:

   fn use context <my-context>

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

開発環境のターミナル・ウィンドウ:

1. デプロイされたファンクションを所有するコンパートメントのOCIDを使用して、新しいFn ProjectのCLIコンテキストを構成します

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

2. 次を入力して、OCI APIのコール時に使用するAPI-urlエンドポイントで新しいコンテキストを構成します。

   fn update context api-url <api-endpoint>

   ここで、<api-endpoint>は、ファンクションAPIのファンクション・エンドポイントのリストにあるエンドポイントの1つです。フォーマットはhttps://functions.<region-identifier>.oci.oraclecloud.comです。例:

   fn update context api-url https://functions.us-phoenix-1.oci.oraclecloud.com

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

   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

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

   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. 「ユーザー」メニューを開き、「ユーザー設定」に移動します。「認証トークン」ページで、「トークンの生成」をクリックします。
3. 「トークンの生成」ダイアログに認証トークンの意味のある説明を入力し、「トークンの生成」をクリックします。新しい認証トークンが表示されます。
4. 認証トークンを、後で取得できる保護された場所にただちにコピーします。これは、コンソールに認証トークンが再度表示されないようにするためです。
5. 「トークンの生成」ダイアログを閉じます。

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

開発環境のターミナル・ウィンドウ:

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. パスワードの入力を求められたら、前に作成してコピーした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 Functionsを使用して最初のファンクションを作成、デプロイおよび起動しました。

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

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

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

これで完了です。