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

OCI Functionsで実行中のファンクションに渡すカスタム構成パラメータを指定する方法をご紹介します。

前提条件および詳細は、ファンクションへのカスタム構成パラメータの渡しを参照してください。

    1. 「アプリケーション」リスト・ページで、カスタム構成パラメータを渡すファンクションを含むアプリケーションを選択します。リストページまたはアプリケーションの検索に関するヘルプが必要な場合は、Listing Applicationsを参照してください。
    2. 次のいずれかを行います。
      • 1つ以上のカスタム構成パラメータをアプリケーション内のすべてのファンクションに渡すには、「構成」を選択して、アプリケーションの「構成」ページを表示します。

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

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

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

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

    5. (オプション)必要に応じて他のカスタム構成パラメータを入力します。
  • ヒント

    時々、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操作を実行して、カスタム構成パラメータを定義します: