[Cloud] Oracle Functions：開発者のためのクイックスタートガイド／Oracle Functions: Serverless On Oracle Cloud - Developer's Guide To Getting Started (Quickly!)

12月にクラウドネイティブサービスについての大規模な大規模なアナウンスをしましたが、その一部としてOracle Functionsという新しいサービスも発表しました。Oracle Functionsは、Functions as a Service（FaaS）、あるいはDockerコンテナを利用して実行されるホストされたサーバーレスだと考えればよいでしょう。サービスのベースとなっているオープンソースであるFn Project自体は新しいものではありませｎ。しかし、Oracleのクラウド経由でサーバーレスファンクションを迅速にデプロイし、起動することができるようになったことで、以前よりも実装がとても容易になりました。このサービスは現時点ではLimited Availabilityです（トライしてみたい方はこちらから登録ください）が、開発者のみなさんが簡単にOracle Cloudでサーバーレスを始められるように、情報をまとめてみようと思います。このポストでは、テナンシーを設定し、Oracle Functionsであなたの最初のアプリケーションやファンクションをデプロイし起動するために必要なステップを一通り見ていきます。

まず始める前に、Oracle Cloudテナンシーの設定を行っておく必要があります。Oracle Functionsは現時点ではPhoenixリージョンのみで利用可能となっているため、Limited Availabilityトライアルを行う場合、あなたのテナンシーがPhoenixリージョンに登録してあることを確認しましょう。リージョンのチェック、登録方法は以下のGIFを見てください。

残っている設定作業はステップが多く時間もかかるものです。誰だって設定作業に時間を取られるのは嫌だし、そんなことするよりも早くコードを書いてファンクションをデプロイしたいですよね……なのでテナンシーでOracle Functionsを使うために必要なステップを全部まとめてシェルスクリプトにしておきました。

ただし、スクリプトに一通り目を通し、何をやっているのかをしっかり理解してからスクリプトを実行するようにしてください。このスクリプトでは、あなたのクラウドテナンシーに以下の変更／追加を加えます：

これらのとても多くの作業を通常、コンソールUIから行わなくてはならなくてはなりません。しかしOCI CLIからこのスクリプトを使用することで、30秒で完了することができるのです。スクリプトへのリンクを貼る前に念押ししますが、スクリプトに目を通し、何をしているのか理解してから使ってください。まず最初に、1~20行目に含まれている、作成するオブジェクトの名前と値のところを修正（あるいは少なくとも確認）する必要があります。

ここまでで必要な警告とディスクレイマーは済ませました。スクリプトはここにあります。ダウンロードしたら実行可能かチェックして、実行しましょう。コンパートメントを作成してから他のオブジェクトに利用可能になるまでにはやや時間がかかる関係で、もしかするとVCNを作成するところでいくつか失敗が発生するかもしれません。これは想定されており、そのあたりに自動リトライ処理を入れてあるので問題ないです。スクリプトによってテナンシーでOracle Functionsを使う準備が整い、次のステップに進むことができるようになるでしょう。以下はスクリプトを実行した結果の出力の例です。

次に、署名鍵を作成しましょう。クイックスタートガイドから引用します：

ここまできてコンソールUIを使うのが面倒だという場合は、以下のようにOCI CLIを使って鍵をアップロードすることもできます：

次に、OCI CLIの設定ファイル（~/.oci/config）をテキストエディタで開き、上記のスクリプトで生成されたprofileセクションを貼り付け、新しい署名鍵の値で上書きしておきましょう。

ここで、Dockerがあなたのローカル環境にインストール済であることを確認してください。たぶん大丈夫だと思いますが、そうでもなかったらDocker docsを見て自分のプラットフォームに合ったものをインストールしてください。インストールされているかは以下のコマンドで確認しましょう：

では、上記のスクリプトで生成しておいた認証情報でDockerにログインしてみましょう：

ユーザー名をスクリプトの出力（<tenency>/<username> の形式）からコピーして使い、生成された認証トークンはDockerログインパスワードとして使用されます。

それではFn CLIをインストールしましょう。GitHubのFn projectに行くとプラットフォームごとのインストール手順が説明されています。うまくいったかどうか確認するには、以下を実行しましょう：

Fn CLIで実行できる全てのコマンドは、command reference docsに説明されています。ブックマークしておくといいでしょうね！

いよいよFnの設定の仕上げにかかりましょう。またFnクイックスタートを参考にします：

Function開発者ユーザーで開発環境にログインして：

以下を入力して新規Fn Project CLIコンテクストを作成します：

以下を入力してFn Project CLIが新しいコンテクストを使用するように指定します：

新しく作ったコンテクストにFunctionsをデプロイしたいコンパートメントのOCIDを設定しましょう：

新しく作ったコンテクストにFn Project APIを呼ぶ際に使用するapi-urlエンドポイントを設定しましょう：

以下は例です：

新しく作ったコンテクストに、DockerレジストリとOracle Functionsと使いたいリポジトリのアドレスを指定しましょう：

以下は例です：

新っく作ったコンテクストに、Oracle Functionsを使うために作成しておいたプロファイルを設定しましょう：

さて、ここまででアプリケーションを作成する準備ができました。Oracle Functionsでは、アプリケーションというのは、共通の設定値のコンテクストを共有しているサーバーレスファンクションのグループのことです。クイックスタートではコンソールUIを使ってアプリケーションを作成する方法が説明されていますが、ここでは引き続きコマンドラインを使って素早く行っていきましょう。以下を実行してアプリケーションを作成します：

先ほど作成したサブネットIDのうち、少なくともひとつをここのJSON配列に含める必要があります。複数のサブネットを含めておくことで可用性を高められます。アプリケーションを表示するには、以下を実行します：

以下を実行してひとつめのファンクションを作成しましょう：

この例ではNodeJSを使用していますが、様々なランタイムがサポートされていることは知っておいてください。現時点ではランタイムはGo、Java 8、Java 9、Node、Python 3.6、Python 3.7、Ruby、Kotlinから選ぶことができます。ファンクションが生成されると、以下のような出力が表示されます：

では、新規作成されたディレクトリに行き、生成されたファイルを見てみましょう。func.yamlファイルはFnがプロジェクトやトリガーなどのメタデータ定義のために使用するファイルです。いったんこのYAMLは置いといて、func.jsをテキストエディタで開いてみましょう。以下のようになっているはずです：

シンプルなHello Worldです。しかしあなたは必要に応じてファンクションをパワフルにすることができます。Oracle Cloudの同一サブネット内のDBと接続したりとか、オブジェクトストレージを使用したりとか、様々なことができます。ここではこのファンクションをデプロイして、起動してみましょう。ファンクションのルートディレクトリ（さっきのYAMLファイルがあったところです）で以下のコマンドを実行するとデプロイできます。以下のような出力が表示されるでしょう：

FnによってファンクションがDockerコンテナにコンパイルされ、DockerコンテナがOracle Dockerレジストリにプッシュされ、こうしてファンクションを起動する準備が整いました。では次のコマンドで起動してみましょう（一つ目の引数はアプリケーション名、二つ目はファンクション名です）：

初回の起動はちょっと時間がかかります。というのも、FnがDockerコンテナをpullして立ち上げなければならないからです。なので次からは速くなりますよ。この方法がファンクションを起動する唯一の方法というわけではありません。HTTPエンドポイントに署名を付けてリクエストするなどの方法はありますが、その話題は別のポストにとっておきましょう。

では、アプリケーションの設定変数を追加してみましょう：

前述の通り、設定はアプリケーション内の全てのファンクションで共有されています。あるファンクションから設定変数にアクセスするには、環境変数から取得してきます。例として使っているNodeファンクションを設定変数を使用するように更新し、デプロイして起動してみましょう：

以上がOracle Functionsでのサーバーレスファンクション開発のスタートガイドの基本的な部分でした。Fnプロジェクトはもっと沢山のガイドを提供しているので、そちらもぜひ読んでみることをおすすめします。もっと深く知りたいという方は、 Limited Availabilityプログラムに登録するのも忘れずに。