Pythonコード専用関数の作成

Pythonアーカイブの要件

Pythonコード専用関数の場合:

• アーカイブには、ルート・レベルのfunction/ディレクトリが含まれている必要があります。
• function/ディレクトリには、ハンドラ・モジュールとアプリケーション・ソース・コードが含まれます。
• ルート・レベルのpython/ディレクトリはオプションで、Pythonの依存関係が含まれています。
• ルート・レベルのresources/ディレクトリはオプションで、ランタイム・リソースが含まれます。
• ルート・レベルのnative/ディレクトリは、マルチアーキテクチャのネイティブ依存性ユースケースでのみオプションです。
• 単一アーキテクチャPython関数の場合、ルート・レベルのnative/は許可されません。
• マルチアーキテクチャPython関数の場合、native/が存在する場合は、アーキテクチャ固有のネイティブ依存性ファイルをnative/fn-arch-x86/およびnative/fn-arch-arm/の下にのみ配置します。
• ハンドラは必須です。
• ハンドラは、<file>.<function>の形式を使用する必要があります。
• ハンドラは、function/ディレクトリのPython関数を参照する必要があります。

Pythonハンドラ

ハンドラは、呼び出す Python関数を識別します。ハンドラは、function/ディレクトリのPythonファイルのPython関数を参照する必要があります。

次の書式を使用します:

<file>.<function>

たとえば、アーカイブにfunction/func.pyが含まれ、ハンドラ・ファンクションの名前がhandlerである場合、次を使用します。

func.handler

単一アーキテクチャのPythonアーカイブ

archive-root/
├── function/
    └── func.py
├── python/     # optional
└── resources/  # optional

ルール:

• function/は必須です。
• python/はオプションです。
• resources/はオプションです。
• native/は、単一アーキテクチャのPython関数では許可されません。
• ハンドラは、function/ディレクトリのPython関数を参照する必要があります。

依存関係のないPythonソースをパッケージ化

mkdir -p build/archive/function
cp func.py build/archive/function/
cd build/archive
zip -r ../function.zip function/

ハンドラ:

func.handler

依存関係を持つPythonソースをパッケージ化

ZIPを作成する前に、依存関係をpython/ディレクトリにインストールします。

mkdir -p build/archive/function

mkdir -p build/archive/python

cp func.py build/archive/function/

python3 -m pip install -r requirements.txt -t build/archive/python

cd build/archive

zip -r ../function.zip function/ python/

リソースを使用する場合は、アーカイブ・ルートにresources/を含めます。

依存性のパッケージ化

OCI Functionsは、ファンクションの作成中にPython依存関係をダウンロードしません。関数を作成または更新する前に、必要な依存関係をアーカイブにパッケージ化します。

ネイティブ依存関係を持つPythonアーカイブ

Python関数は、.soファイルや特定のLinuxアーキテクチャ用に構築されたPythonホイールなどのコンパイル済ネイティブ・コードを含むパッケージに依存できます。

単一アーキテクチャPython関数の場合:

• ルート・レベルのnative/は含めないでください。
• 依存関係をpython/のすぐ下にパッケージ化します。
• 依存関係が正しいLinuxプラットフォームおよびアーキテクチャ用に構築されていることを確認します。

単一アーキテクチャ・アプリケーションの場合、ネイティブ・コードとの依存関係を含むPythonの依存関係をpython/の下にパッケージ化します。

archive-root/
├── function/
    └── func.py
├── python/
    └── <python dependencies, including native dependencies for the application architecture>
└── resources/ # optional

マルチアーキテクチャPython関数の場合:

• function/の下に共有ソースをパッケージ化します。
• 必要に応じて、Pure-Pythonの依存関係をpython/の下にパッケージ化します。
• アーキテクチャ固有のネイティブ依存関係のパッケージ化:
  • native/fn-arch-x86/
  • native/fn-arch-arm/

archive-root/
├── function/
    └──  func.py
├── python/      # optional pure-Python dependencies
├── resources/   # optional
└── native/
    ├── fn-arch-x86/
    └── fn-arch-arm/

ルール:

• native/は、ファンクションがアーキテクチャ固有のネイティブ依存性を使用する場合にのみ必要です。
• マルチアーキテクチャ・アプリケーションにnative/が存在する場合は、fn-arch-x86/とfn-arch-arm/の両方が含まれている必要があります。
• ネイティブ依存性ファイルは、一致するアーキテクチャ・ディレクトリの下にのみ配置します。
• function/は常に必須です。

Pythonランタイムの動作

Python FDKは、コード専用関数の管理対象Pythonランタイムに含まれています。ハンドラ・モジュール、アプリケーション・コードおよび必要な依存関係をアーカイブにパッケージ化します。

Pythonコード専用関数の作成

Pythonコード専用関数を作成するには、コード専用関数の作成の手順に従います。たとえば、コンソールを使用してPythonコード専用ファンクションを作成するには:

1. 「アプリケーション」リスト・ページで、Pythonコード専用ファンクションを作成するアプリケーションを選択します。リストページまたはアプリケーションの検索に関するヘルプが必要な場合は、Listing Applicationsを参照してください。

2. 「Functions」タブを選択します。

   「関数」リスト・ページが開きます。選択したアプリケーションのすべての関数が表に表示されます。

3. 「アーカイブから作成」を選択し、ファイル・ソース、Pythonアーカイブ、サポートされているPythonランタイム、Pythonハンドラなど、Pythonコード専用関数の詳細を指定します。

   Pythonコード専用関数の場合、関数の作成時にハンドラを指定する必要があります。

4. 必要に応じて、ファンクションの他の詳細を指定します(コードのみのファンクションの作成を参照)。
5. 「作成」を選択してファンクションを作成します。

   Pythonコード専用関数が作成され、他の関数と同様に起動できます。

トラブルシューティング