Scheduling Functions で OCI CLI を cron っぽく定期実行してみる。(Oracle Cloud Infrastructure)

Last updated at 2024-11-12Posted at 2024-11-11

前回(下記)の続編的な記事になります。Scheduling Functions で OCI CLI を cron っぽく定期実行してみるやで。
彡(ﾟ)(ﾟ)

1. やってみること

前述の記事で作成した OCI CLI の Functions を応用して、OCI Resource Scheduler の Scheduling Functions で定期実行します。

スケジューリング関数
https://docs.oracle.com/ja-jp/iaas/Content/Functions/Tasks/functionsschedulingfunctions-about.htm

今回は Autonomous Database Serverless(以下 ADB-S) を OCI CLI + Scheduling Functions で 1時間毎に起動/停止してみます。

2. 権限付与(リソース・プリンシパル)

まず OCI Functions が OCI CLI を実行できるようにするための権限付与(リソース・プリンシパル)を行います。
動的グループは前回記事のものを流用します。ADB-S を起動/停止するために下記の権限(ポリシー)を動的グループに付与します。

Allow dynamic-group ayu-dynamic-group01 to use autonomous-database in compartment ayu-compartment01

次に Scheduling Functions が Functions を実行できるように新規に動的グループと権限(ポリシー)を作成します。

動的グループは下記で resource.type に resourceschedule を指定します。

ALL {resource.type='resourceschedule'}

新しく作った動的グループに付与する権限(ポリシー)は下記としています。

Allow dynamic-group 'Default'/'ayu-dynamic-group02' to manage functions-family in compartment ayu-compartment01

Scheduling Functions による Functions の実行に必要な動的グループや権限(ポリシー)は下記マニュアルも参照して下さい。

関数のスケジュール
https://docs.oracle.com/ja-jp/iaas/Content/Functions/Tasks/functionsscheduling.htm

3. OCI CLIコマンドの動作確認と Functions の準備

まず ADB-S を起動/停止する OCI CLIコマンドを動作確認します。

# ADB-S を起動する OCI CLIコマンド
oci db autonomous-database start --autonomous-database-id ocid1.autonomousdatabase.oc1....

# ADB-S を停止する OCI CLIコマンド
oci db autonomous-database stop --autonomous-database-id ocid1.autonomousdatabase.oc1....

次に前回記事の要領で OCI CLIコマンドを実行する Functions の関数を2つ用意します。atp-start という関数と atp-stop という関数を作成して、それぞれ OCI CLIパラメータの OCI_CLI_COMMAND変数を設定しています。

下記では fnコマンドで OCI_CLI_COMMAND変数を設定していますが、OCIコンソールからも設定可能です。

fn config function ayu-functions1 atp-start OCI_CLI_COMMAND "db autonomous-database start --autonomous-database-id ocid1.autonomousdatabase.oc1...."
fn config function ayu-functions1 atp-stop OCI_CLI_COMMAND "db autonomous-database stop --autonomous-database-id ocid1.autonomousdatabase.oc1...."

設定した OCI_CLI_COMMAND変数は下記のように OCIコンソールから参照可能です。

fn invoke でそれぞれ動作を確認します。

[opc@ays-prv-compute02 ~]$ fn invoke ayu-functions1 atp-start
{
  "data": {
    "actual-used-data-storage-size-in-tbs": 0.004418373107910156,
    "allocated-storage-size-in-tbs": 0.0068359375,
    "apex-details": {
      "apex-version": null,
      "ords-version": "24.3.0.262.0924"
    },
：
  "etag": "beda009e",
  "opc-work-request-id": "ocid1.coreservicesworkrequest.oc1.phx.abyhqljsoz64u46griyuvj5eg2mfbyg4pw44ya3osifj2u64wp4zmm623qba"
}

[opc@ays-prv-compute02 ~]$ fn invoke ayu-functions1 atp-stop
{
  "data": {
    "actual-used-data-storage-size-in-tbs": 0.004418373107910156,
    "allocated-storage-size-in-tbs": 0.0068359375,
    "apex-details": {
      "apex-version": null,
      "ords-version": "24.3.0.262.0924"
    },
：
  "etag": "60e9b758",
  "opc-work-request-id": "ocid1.coreservicesworkrequest.oc1.phx.abyhqljsyg7yllegwuiebcc6igzwhco2xectmgy5aegwd6deyzooyhomhv6a"
}

Functions による起動/停止の実行は ADB-S の Work requests からも確認できます。

4. Scheduling Functions による定期実行設定

OCIコンソールの左上のハンバーガーメニュー → Governance&Administoration → Resource Scheduler の Shcedules をクリックします。

Create a scheduleボタンで定期実行ジョブを作成します。まずATP起動のスケジュール名と詳細を入力します。

Resource selection method は Static を、実行するリソースは 3. で準備した ADB-S起動の Functions関数を選択します。

Specify schedule using は Cron expression を選択します。Recurrence details に cron書式の起動時刻を記述します。分時日月曜日の順番となります。起動は奇数時刻に実行するように設定してみます。Time は現在時刻より後の時刻を UTC で設定して下さい。