はじめに

こちらでFn Projectのアーキテクチャを整理しましたが、これをもとにFn ProjectのマネージドサービスであるOCI Functionsのアーキテクチャを整理したいと思います。

事前準備

今回はFunctionsのクライアントとして、Oracle Linuxのインスタンスを使用します。
Docker, Fn CLIなど必要なパッケージはインストール済みです。

ポリシーの設定

以下のポリシーを設定します。

Allow service FaaS to use virtual-network-family in compartment <コンパートメント名>
Allow service FaaS to read repos in compartment <コンパートメント名>

VCNの作成

今回は作成済みのVCNを利用します。

OCIRの作成

今回はコンテナレジストリとしてOCIRを使用します。
事前に作成しない場合、Functionデプロイ時にルートコンパートメントにリポジトリが作成されます。

今回は以下のようにプライベートリポジトリを作成します。リポジトリ名は任意の名称/Function名とします。

Functionsの作成、実行

アプリケーションの作成

OCIのコンソールからアプリケーションを作成します。
アプリケーション名、VCN、サブネットを以下のように指定します。

こちらを確認すると、アプリケーションを作成するとFn ServerもFunction単位で作成されるようです。

以降はアプリケーション作成後のコンソールのスタート・ガイドにサンプルファンクションの実行手順がありますので、これに沿って設定します。
今回はローカル設定の手順です。

Functionの初期化、雛形作成

引数に言語とFunction名を指定して雛形を作成します。

$ fn init --runtime go hello-func
Creating function at: ./hello-func
Function boilerplate generated.
func.yaml created.
$ ls -l hello-func/
total 12
-rw-r--r--. 1 opc opc 521 Jul 10 06:33 func.go
-rw-r--r--. 1 opc opc 152 Jul 10 06:42 func.yaml
-rw-r--r--. 1 opc opc  58 Jul 10 06:33 go.mod
$ cd hello-func/

Contextの設定

デフォルトでContextはLocalhostになっていますので、新しいContextを追加して、OCIに接続するように変更します。

$ fn create context lhr --provider oracle
Successfully created context: lhr 
$ fn use context lhr
Now using context: lhr 
$ fn list context
CURRENT NAME    PROVIDER        API URL                 REGISTRY
        default default         http://localhost:8080
*       lhr     oracle

FunctionをデプロイするコンパートメントのOCIDを設定します。

$ fn update context oracle.compartment-id ocid1.compartment.oc1..aaaaaaaamyemvazvbgl42f5pi7gzxxxxxxxxxxxxxxxxxxxxxxxxxxx
Current context updated oracle.compartment-id with ocid1.compartment.oc1..aaaaaaaamyemvazvbgl42f5pi7gzxxxxxxxxxxxxxxxxxxxxxxxxxxx

API URLを指定します。これはリージョンによって異なります。

$ fn update context api-url https://functions.uk-london-1.oraclecloud.com
Current context updated api-url with https://functions.uk-london-1.oraclecloud.com

Buildしたコンテナイメージを保存するリポジトリを設定します。
これは事前に作成したリポジトリからFunction名を除いて設定します。

$ fn update context registry lhr.ocir.io/orasejapan/lhr-functions-repo-01
Current context updated registry with lhr.ocir.io/orasejapan/lhr-functions-repo-01

確認します。

$ fn list context
CURRENT NAME    PROVIDER        API URL                                         REGISTRY
        default default         http://localhost:8080
*       lhr     oracle          https://functions.uk-london-1.oraclecloud.com   lhr.ocir.io/orasejapan/lhr-functions-repo-01

Functionのデプロイ

OCIRにログインします。ログインする際のパスワードは認証トークンです。
認証トークンは事前に作成する必要がありますが、今回はこちらで作成したトークンを利用します。

$ docker login lhr.ocir.io

アプリケーション名を指定してFunctionをデプロイします。

$ fn deploy --app app01
Deploying hello-func to app: app01
Bumped to version 0.0.2
Using Container engine docker
Building image lhr.ocir.io/orasejapan/lhr-functions-repo-01/hello-func:0.0.2 ......................................
Updating function hello-func using image lhr.ocir.io/orasejapan/lhr-functions-repo-01/hello-func:0.0.2...

Buildされたコンテナイメージが指定したOCIRのリポジトリに保存されています。

fnコマンドでもアプリケーションとFunctionが確認できます。

$ fn list app
NAME    ID
app01   ocid1.fnapp.oc1.uk-london-1.aaaaaaaaxp5k5v6q3wqqfbyctrqzsvofpxxxxxxxxxxxxxxxxxxxxxxxx
$ fn list f app01
NAME            IMAGE                                                           ID
hello-func      lhr.ocir.io/orasejapan/lhr-functions-repo-01/hello-func:0.0.2   ocid1.fnfunc.oc1.uk-london-1.aaaaaaaarbcpzevlocpdtpcn622ep4qnzcz4x27prmqtkeqswbpt5s6x7bhq

Functionの実行

以下のコマンドを実行してFunctionを実行します。

$ fn invoke app01 hello-func
{"message":"Hello World"}

Functionを実行すると以下のような流れでコードが実行されます。

コンテナイメージのPull
コンテナの実行
コードの実行
コンテナの削除

Functionが複数回実行された場合の動作は、以下のように実行されたタイミングによって異なります。

ファンクションの実行が終了し、アイドル状態の期間が経過すると、Dockerコンテナは削除されます。コンテナが削除される前に、OCIファンクションが同じファンクションに対する別のコールを受信すると、2番目のリクエストは同じ実行中のコンテナにルーティングされます。OCIファンクションが、実行中のコンテナ内で現在実行中のファンクションに対するコールを受け取ると、OCIファンクションは水平方向にスケーリングして、両方の着信リクエストを提供し、2番目のDockerコンテナが開始されます。