ファンクションに渡すカスタム構成パラメータの指定

• コンソール
• CLI
• API

• 1. ファンクション開発者としてコンソールにサインインします。
  2. ナビゲーション・メニューを開き、「開発者サービス」を選択します。「ファンクション」で、「アプリケーション」を選択します。
  3. OCI Functionsで使用しているリージョンを選択します。

     Fn ProjectのCLIコンテキストで指定されているDockerレジストリと同じリージョンを使用することをお薦めします。 Oracle Cloud Infrastructureに接続するためのFnプロジェクトのCLIコンテキストの作成を参照してください。

  4. Fn ProjectのCLIコンテキストで指定されているコンパートメントを選択します。 Oracle Cloud Infrastructureに接続するためのFnプロジェクトのCLIコンテキストの作成を参照してください。

     「アプリケーション」ページには、コンパートメントに定義されているアプリケーションが表示されます。

  5. カスタム構成パラメータを渡すファンクションが含まれているアプリケーションの名前をクリックします:

     • アプリケーションのすべてのファンクションに1つ以上のカスタム構成パラメータを渡すには、「構成」をクリックして、アプリケーションの「構成」ページを表示します。

     • 1つ以上のカスタム構成パラメータを特定のファンクションに渡すには、ファンクションの名前をクリックし、「構成」をクリックして、ファンクションの「構成」ページを表示します。

  6. 「構成」ページで、最初のカスタム構成パラメータについて次の詳細を指定します。

     • キー:カスタム構成パラメータの名前。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。たとえば、usernameです
     • 値: カスタム構成パラメータの値。値には印刷可能なUnicode文字のみを使用する必要があります。たとえば、jdoeです

  7. プラスのボタンをクリックして、新しいカスタム構成パラメータを保存します。

     OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4 Kbです。シリアルにエンコードされた構成オブジェクトのサイズが4 Kbを超える場合は、新しいカスタム構成パラメータを保存できません。

  8. (オプション)必要に応じて他のカスタム構成パラメータを入力します。
• ヒント
  
  時々、Fn ProjectCLIの新しいバージョンがリリースされます。最新バージョンがインストールされていることを定期的に確認することをお勧めします。詳細は、Fn ProjectのCLIをアップグレードするステップを参照してください。

  Fn ProjectのCLIを使用してファンクションに渡すカスタム構成パラメータを指定するには:

  1. 開発環境にファンクション開発者としてログインし、ターミナル・ウィンドウを開きます。

  2. 既存のアプリケーション内のすべてのファンクションに渡す1つ以上のカスタム構成パラメータを指定するには、次のように入力します:

     fn config app <app-name> <key> <value>

     ここでは:

     • <app-name>は、カスタム構成パラメータを渡すファンクションが含まれているアプリケーションの名前です。
     • <key>は、カスタム構成パラメータの名前です。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。
     • <value>は、カスタム構成パラメータに指定する値です。値には印刷可能なUnicode文字のみを使用する必要があります。

     例:

     fn config app acmeapp username jdoe

     次に注意してください:

     • fn create appコマンドを使用して新しいアプリケーションを作成する際、アプリケーション全体のカスタム構成パラメータを定義することもできます。
     • OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4Kbです。

  3. 特定のファンクションに渡す1つ以上のカスタム構成パラメータを指定するには、次のように入力します:

     fn config function <app-name> <function-name> <key> <value>

     ここでは:

     • <app-name>は、カスタム構成パラメータを渡すファンクションが含まれるアプリケーションの名前です。
     • <function-name>は、カスタム構成パラメータを渡すファンクションの名前です。
     • <key>は、カスタム構成パラメータの名前です。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。
     • <value>は、カスタム構成パラメータに指定する値です。値には印刷可能なUnicode文字のみを使用する必要があります。

     例:

     fn config function acmeapp acme-func username jdoe

     次に注意してください:

     • fn create functionコマンドを使用して新しいファンクションを作成する際に、ファンクション固有のカスタム構成パラメータを定義することもできます。
     • OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4Kbです。

• 次のAPI操作を実行して、カスタム構成パラメータを定義します:

  • CreateFunction
  • UpdateFunction
  • CreateApplication
  • UpdateApplication