OCI Functions用のFn CLI: より多くの機能、シンプルなワークフロー (2026/08/31)

OCI Functions用のFn CLI: より多くの機能、シンプルなワークフロー (2026/08/31)

https://blogs.oracle.com/cloud-infrastructure/fn-cli-enhancements-for-oci-functions

投稿者:Winston Lin | Principal Product Manager

 Senior Member of Technical Staff

Fn CLIの機能強化を発表できることを嬉しく思います。これにより、開発者向けCLIエクスペリエンスにOCIの機能がさらに追加され、一般的なコマンドが簡素化され、デプロイメントの自動化が効率化されます。OCI Functionsを使用する開発者は、これまで本番ワークフローを管理するために、Fn CLI、OCI CLI、生の注釈、および低レベルのリクエストペイロードの間を行き来する必要がありました。 

最新のFn CLIの機能強化により、開発者は初期化やデプロイから構成、呼び出し、自動化に至るまで、OCI Functionsのライフサイクルのより多くの部分をFn CLI内で完結させることができます。

今回のアップデートは、以下の3つの分野に焦点を当てています。

  1. Fn CLI に直接組み込まれた、より多くの本b何機能
  2. 一般的な設定のためのよりシンプルなコマンドオプション
  3. 再現可能なCI/CDおよび自動化ワークフローのサポート強化

Fn CLI からファンクションのライフサイクルのより多くの部分を操作します

Fn CLIは、本番環境でOCI Functionsを構成および運用するために必要な機能をさらに多くサポートするようになりました。

プロビジョニングされた同時実行の設定

プロビジョニングされた同時実行設定は、関数の作成時または更新時に直接構成できるようになりました。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create function <app> <fn> <img> \
  --provisioned-concurrency constant:5</fn></app>

後で無効にするには:


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn update function <app> <fn> \
  --provisioned-concurrency none</fn></app>

プロビジョニングされた同時実行数は、初期化時func.yaml構成して、次の場所に永続化することもできます


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn init --runtime java hello-java \
  --provisioned-concurrency constant:5

長時間実行される関数を設定する

分離実行は、読みやすい実行時間と簡潔な出力形式で設定できるようになりました。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create function <app> <fn> <img> \
  --detached-timeout 20m \
  --on-success stream:<stream_ocid> \
  --on-failure notifications:<topic_ocid>

宛先は明示的に削除できます。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn update function <app> <fn> \
  --clear-on-success \
  --clear-on-failure

Fn CLIには、分離呼び出し、呼び出し意図、ドライラン検証、呼び出しID表示など、より多くの呼び出し制御機能が追加されています。

事前構築済み関数を見つけて展開する

Fn CLIから直接、既成関数を検索および作成できるようになりました。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn list pbfs --search "Document"

fn create function <app> <fn> \
  --pbf <pbf_listing_ocid>

Fn CLIは、トレース、イメージポリシー構成、セキュリティ属性、ネットワークセキュリティグループなど、アプリケーションおよび機能操作全体にわたるOCI固有の追加構成も公開します。

下位レベルの設定をよりシンプルなコマンドオプションに置き換える

これまで注釈やリクエストペイロードを必要としていたいくつかのワークフローは、Fn CLIオプションを通じて直接表現できるようになりました。

アプリケーションサブネットを構成する

以前は、アプリケーションのネットワーク設定には生の注釈JSONが必要でしたが、現在はサブネットを直接指定できます。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create app <app> \
  --subnet-id <subnet_ocid>

複数のサブネットの場合は、以下のオプションを繰り返してください。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create app <app> \
  --subnet-id <first_subnet_ocid> \
  --subnet-id <second_subnet_ocid>

タグを直接管理する

Fn CLIには、自由形式タグと定義済みタグを管理するための専用オプションが追加されました。
- タグ
--定義済みタグ
--タグを削除
--定義済みタグを削除
--タグをクリアする
--clear-freeform-tags
--定義済みタグをクリアする

例えば:


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn update function <app> <fn> \
  --tag Team=Payments \
  --remove-tag Department \
  --clear-defined-tags

これらのオプションにより、下位レベルのペイロードを構築することなく、一般的な構成変更を容易に発見し、自動化できます。

より信頼性の高い自動化を構築する

Fn CLIは、CI/CDパイプラインおよび反復可能なデプロイメントワークフロー向けに設計された追加の制御機能を提供するようになりました。

JSONを使用してパラメータを指定します。

この新しい --from-json オプションでは、パラメータをインラインで指定するか、ファイルから指定することができます。


クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create app my-app \
  --from-json file:///absolute/path/app-create.json
クリップボードにコピーされました
エラー: コピーできませんでした
クリップボードにコピーされました
エラー: コピーできませんでした
fn create function my-app my-fn \
  --from-json file:///absolute/path/fn-create.json

これは、入力が再利用可能なバージョン管理された構成として保存されるデプロイメントパイプラインに役立ちます。

制御リソース操作

OCIスタイルのリクエストおよびライフサイクル制御は、アプリケーションおよび機能の操作全体にわたって利用可能です。

--if-match 楽観的並行性では、
--wait-for-state 目標ライフサイクル状態になるまで待機し、
--max-wait-seconds 合計待機時間を制限して
--wait-interval-seconds ポーリング頻度を制御します。

これらの制御機能により、自動化されたワークフローは、リソースの状態変化や同時更新をより予測可能な形で処理できるようになります。

Functionsライフサイクルのより多くの部分で単一のCLIを使用


これらの機能強化により、Fn CLIはOCI関数の開発と運用において、より包括的なインターフェースとなります。

開発者はFn CLIを使用して以下のことができるようになりました。

  • OCIデプロイメント設定を使用して関数を初期化します。
  • アプリケーションと機能の作成および更新。
  • プロビジョニングされた同時実行やデタッチ実行などの本番環境向け機能を設定します。
  • 事前構築済みの関数を見つけて展開します。
  • ネットワーク、タグ、セキュリティ、およびリクエストの動作を管理します。
  • 分離制御、インテント制御、およびドライラン制御を使用して関数を呼び出します。
  • 再現性のある、JSON駆動型のCI/CDワークフローを構築する。

Fn CLI は、ローカル Fn サーバーのワークフローとの互換性を維持しています。OCI 固有のオプションは、ローカル Fn サーバーに対して使用される際に識別されます。

アップグレードFn CLI

OCI Functionsワークフローでこれらの機能を使用するには、最新のFn CLIリリースにアップグレードしてください。まずは、プロビジョニングされた同時実行の設定、デタッチモードでの関数の呼び出し、サブネットの設定、JSONを使用したデプロイなど、本番環境のワークフローを1つFn CLIに移行してみましょう。その後、その他の機能強化を活用して、開発および運用ライフサイクルをさらに簡素化してください。

リソース

コメント

このブログの人気の投稿

Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20)

ミリ秒の問題: BCCグループとOCIが市場データ・パフォーマンスを再定義する方法(AWSに対するベンチマークを使用) (2025/11/13)

Oracle Enterprise Manager 24aiの概要 (2024/12/18)