OracleFunctionsのセットアップ手順を記載します。
Fn,OracleFunctionsについて、どんなものかメモ書きを掲載したのでよろしければご覧下さい。
・Oracle Functionsに関するメモ
参考:
クイックスタート
OCI設定
現在Phoenixリージョンのみサービスが提供されているため、OCIコンソール上でus-phoenix-1を選択してください。
※2019/08/01現在、サービスが公開されているためどのリージョンでもよいです。
グループとユーザの作成
Oracle Functions を利用するユーザと、ユーザが所属するグループを作成します。
既存ユーザでもよいと思いますが、ユーザをグループに追加するのを忘れずにしてください。
・グループ作成
Identity > Groups > Create Groupより
Name: Fn-Group (任意)
Description: Fn-Group (任意)
上記入力し「Submit」を押す。
・ユーザ作成
Identity > Users > Create Userより
Name: fn-user (任意)
Description: fn-user (任意)
上記入力し「Submit」を押す。
ユーザ一覧より作成したユーザをクリックし、左下Groups > Add User to Groupより
先程作成したグループを選択し「Add」を押す。
コンパートメントの作成
コンパートメントも同様にOracleFunctions用のものを作成します。
Identity > Compartments > Create Compartmentより
Name: fn-compartment (任意)
Description: fn-compartment (任意)
VCNとSubnet作成
作成したコンパートメント内に VCNを作成します。
インターネットゲートウェイを作成し、ルートテーブルをインターネットゲートウェイへのトラフィックを許可するように設定します。
検証用であればチュートリアルのように、Create Virtual Cloud Network Plus Related Resourcesで
自動で作成してもよいかもしれません。
IAMポリシーの作成
作成したグループにFaaS(Oracle Functions)サービスが操作できるようポリシーの設定を行います。
Identity > Policies > 左下COMPARTMENTでルートコンパートメントを選択 >Create Policyより
Name: fn-policy(任意)
Description: fn-policy(任意)
以下Policy Statementsを追加して「create」
Allow group <1で作成したグループ名> to manage repos in tenancy
Allow service FaaS to read repos in tenancy
左下COMPARTMENTで今回作成したコンパートメントを選択 > Create Policyより
Name: fn-policy(任意)
Description: fn-policy(任意)
以下Policy Statementsを追加して「create」
Allow group <1で作成したグループ名> to manage functions-family in compartment <2で作成したコンパートメント名>
Allow group <1で作成したグループ名> to manage vnics in compartment <2で作成したコンパートメント名>
Allow group <1で作成したグループ名> to inspect subnets in compartment <2で作成したコンパートメント名>
Allow service FaaS to use virtual-network-family in compartment <2で作成したコンパートメント名>
Auth tokenの生成
Identity > Users > 先程作成したユーザ選択 > 左下Auth Tokens > Generated Token
※GENERATED TOKENで表示されるパスワードは後程必要になるため必ずメモに控えて下さい!!
開発環境の構築
ファンクション開発環境を構築するためサーバをたてます。
サーバはクラウド上でもローカルの仮想環境でもよいとのこと。
今回PhoenixリージョンにOracle Linux Server 7.6を立て、簡単な初期設定(yum update、selinux、firewalld無効、タイムゾーン設定)をした後の作業です。
OCI CLIインストール
以下rootユーザで基本デフォルト設定のままセットアップしていきます。適宜環境に合わせてください。
・インストール
# bash -c "$(curl ?L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
以下インストール先ディレクトリ、設定ファイルに関する質問が表示される。
===> In what directory would you like to place the install? (leave blank to use '/root/lib/oracle-cli'): そのままEnter
===> In what directory would you like to place the 'oci' executable? (leave blank to use '/root/bin'): そのままEnter
===> In what directory would you like to place the OCI scripts? (leave blank to use '/root/bin/oci-cli-scripts'): そのままEnter
===> Currently supported optional packages are: ['db (will install cx_Oracle)']
What optional CLI packages would you like to be installed (comma separated names; press enter if you don't need any optional packages)?: そのままEnter
===> Modify profile to update your $PATH and enable shell/tab completion now? (Y/n): y
===> Enter a path to an rc file to update (leave blank to use '/root/.bashrc'): そのままEnter
確認
# oci -v
2.5.19
・セットアップ
こちらも鍵の作成など一旦デフォルトで設定。
# oci setup config
以下設定ファイル、OCIDなど指定
Enter a location for your config [/root/.oci/config]: そのままEnter
Enter a user OCID: 今回作成したユーザのOCIDをコピー貼り付け (OCIコンソールメニューIdentity>Usersより確認)
Enter a tenancy OCID: fullenergy120のテナンシーIDをコピー貼り付け (OCIコンソール右上の人マークより確認)
Enter a region (e.g. ca-toronto-1, eu-frankfurt-1, uk-london-1, us-ashburn-1, us-gov-ashburn-1, us-gov-chicago-1, us-gov-phoenix-1, us-langley-1, us-luke-1, us-phoenix-1): us-phoenix-1
Do you want to generate a new RSA key pair? (If you decline you will be asked to supply the path to an existing key.) [Y/n]: y (別でも作成できるが、ここで作成してしまう)
Enter a directory for your keys to be created [/root/.oci]: そのままEnter
Enter a name for your key [oci_api_key]: そのままEnter
Enter a passphrase for your private key (empty for no passphrase): 鍵にパスフレーズ必要なければそのままEnter
・ユーザにAPI Keyを追加
# cat ~/.oci/oci_api_key_public.pem
-----BEGIN PUBLIC KEY-----
~ 公開鍵の内容が表示される。
-----END PUBLIC KEY-----
この公開鍵をコピーして、今回作成したユーザにAPI Keyを設定します。
OCIコンソール上にて、
Identity > Users > 該当ユーザ選択 > Add Public Key > コピーした公開鍵を貼り付けて「Add」
dockerインストール
・リポジトリ設定
# vi /etc/yum.repos.d/docker.repo
以下記載
[dockerrepo]
name=Docker Repository
baseurl=https://yum.dockerproject.org/repo/main/oraclelinux/7
enabled=1
gpgcheck=1
gpgkey=https://yum.dockerproject.org/gpg
・インストール
# yum install docker-engine
# dockerd --version
Docker version 18.09.1-ol, build c3ab8a8
・起動、自動起動設定
# systemctl start docker.service
# systemctl enable docker.service
FN CLIインストール・設定
・インストール
# curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh
# fn version
Client version is latest version: 0.5.84
Server version: ?
・コンテキスト設定
コンテキスト名は任意。ここではfn-context。
コンテキスト作成
# fn create context fn-context --provider oracle
使用するコンテキスト指定
# fn use context fn-context
コンテキストの一覧と、使用するコンテキストにアスタリスクが表示される。
# fn ls contexts
コンパートメントID指定
# fn update context oracle.compartment-id 今回作成したコンパートメントのID
使用するエンドポイント指定
# fn update context api-url https://functions.us-phoenix-1.oraclecloud.com
※上記PHOENIXリージョンの場合、東京リージョンの場合は以下
https://functions.ap-tokyo-1.oraclecloud.com
Docker Registry と Oracle Functions で使用するリポジトリの指定
# fn update context registry phx.ocir.io/テナンシー名/任意のリポジトリ名
※上記OCIRのリージョンコード phx.ocir.io の場合。
東京リージョンの場合は nrt.ocir.io です。
プロファイル指定
# fn update context oracle.profile DEFAULT
※OCI CLIインストール時に設定したプロファイル名を指定。cat ~/.oci/config で確認。ここではDEFAULTを使用しているがFn用に作成したほうがよい。
# docker login phx.ocir.io
Username: テナンシー名/今回作成したユーザ名
Password: ユーザに追加したAuth Tokenのパスワード
Login Succeededと表示されればOK。
※root以外のユーザで設定した場合、dockerに関するエラーで認証に失敗する。
その場合そのユーザをdockerグループに追加し、docker再起動する。
usermod -g docker グループに追加したいユーザ
systemctl restart docker.service
テスト関数実行
ブラウザで以下指定してOracle Functionのコンソール画面を開きます。
https://console.us-phoenix-1.oraclecloud.com/functions/
テスト用にアプリケーションを作成します。
※Oracle Functionsはアプリケーションという枠をまず作成し、そこに複数の関数を作成して管理します。
Create Applicationより
NAME: test-go
VCN: 今回作成したVCN
SUBNETS:PHX-AD-1から3まで指定
上記で「create」します。
作成後、Fnコマンドで操作します。
アプリケーション一覧表示
# fn list apps
NAME ID
※作成したアプリケーションが表示される。
作業用ディレクトリ作成
# mkdir ~/fn-test/
# cd ~/fn-test/
Goの初期ファンクションを作成。
# fn init --runtime go helloworld-func
ファンクションをDockerImageとしてBuildし、OCIRにPush。
# cd helloworld-func
# fn -v deploy --app 作成したアプリケーション名(今回はtest-go)
※-v オプションをつけたほうがデプロイ内容、進捗が確認できてよいと思います。
デプロイした関数の確認
# fn list functions test-go
# ファンクション呼び出し実行
fn invoke test-go helloworld-func
"Hello World !' が表示されること。
※初回は少し時間かかります(dockerコマンドがいろいろ走ってる？)。2回目以降はすぐ表示されます。
関数を編集したい場合、編集後にfn deployでデプロイし直せば反映されます。
今回はGoのテスト関数でしたが、サポートされている言語(fn initのオプションで現在選択できるもの)は以下になります。
go, java, java11, java8, kotlin, node, python, python3.6, python3.7.1, ruby
また以下関連記事のリンクにてOracle Functions,Fnの検証、作成例を掲載しています。
是非ご覧になって下さい。
関連記事
・Oracle FunctionsでAPEXのRestful Serviceと連携
・Oracle FunctionsでTensorFlowによる画像分類
・Oracle FunctionsでEmail Deliveryと連携しメール送信
・Oracle FunctionsでObject Storage操作 (テキストを格納・取得+テキストをPDFに変換)
・Fn Project - Fn Server構築 (Oracle Linux7.6)
・Oracle FunctionsでOCI Go SDKを使いインスタンス操作
・Fn Project - FnとAWS Lambda連携（近日掲載）