さくらクラウド高火力 API
Dockerfile nginx イメージ API から index.html 表示
Dockerfile nginx イメージで index.html 表示
では、Dockerfile を使って独自の nginx イメージを作成しこのイメージを使って index.html ファイルを表示しました。
今回はこれを API を使って起動したいと思います。
私の ubuntu 端末 Windows11 WSL2 Ubuntu 24.04 LTS から高火力 DOK への API
を使用するための具体的な手順を説明します。
API を呼出には curl コマンドを使用します。
この時 curl コマンドのオプションを理解しておく必要があります。
-u / --user: ベーシック認証などのユーザー名とパスワードを指定します。
API キー を設定します。
-X / --request: 使用する HTTPメソッド(GET, POST, PUT, DELETE など)を指定します。
-H / --header: リクエストに任意の HTTP ヘッダーを追加します。
今回レスポンスは JSON なので基本的には
-H "Content-Type: application/json"
とします。
-d / --data: POST リクエストでデータを送信します。
指定すると自動的に POST メソッドになります。
さくら DOK API my-nginx イメージ 起動タスク作成
さくらクラウド高火力 DOK API を使用して my-nginx を起動するタスクを作成します。
さくらクラウド高火力 API--API からタスク一覧取得--ubuntu printenv 実行タスク
タスクの登録
+ "containers": [・・・], のあたりの「+」をクリックしてください。
が参考になります。
概要は
curl -u "{アクセストークン}:{アクセストークンシークレット}" \
-X POST \
-H "Content-Type: application/json" \
-d
'{
"Name": "my-nginx-api",
"Image": "my-nginx",
"plan": "v100-32gb",
"http": {
"port": 80,
"path": "/"
},
"ssh": {
"shell": "/bin/sh",
"host_name": "my-nginx-ssh",
"port": 0
},
}'
のようになります。
もう少し説明を加えます。
curl -u
SAKURA_ACCESS_TOKEN と $SAKURA_ACCESS_TOKEN_SECRET
を設定します。
これはすでに、環境変数として
$SACS_TK と $SACS_S
に設定済です。
curl -u "$SACS_TK:$SACS_S"
この環境変数については
外部プログラムからさくら高火力 DOK コンテナ起動--さくらクラウド高火力 API 準備Ⅱ
が参考になります。
curl -X
タスクを設定するのですから POST を使います。
設定する URL は
https://secure.sakura.ad.jp/ cloud/zone/is1a/api/managed-container/1.0/tasks/
です。
これはすでに、
環境変数 "$ISI_URL_T"
として設定済です。
-X POST "$ISI_URL_T"
curl -H
HTTP ヘッダーを追加します。
レスポンスは JSON なので基本的には
-H "Content-Type: application/json"
とします。
curl -d
POST リクエストで送信するデータ内容です。
・"name": "my-nginx-api",
名前は my-nginx-api としました。
適当です。
"containers" の中にはタスク詳細を記入します。
・"image": "my-nginx:latest",
my-nginx イメージの最新版を使います。
・"registry":
レジストリー認証情報で登録した値を記入します。
コンテナレジストリにイメージをビルド--プライベートレジストリーの登録
を参照。
・"command":
イメージの中で指定済み、省略します。
・"http":
my-nginx がリッスンしているポートは 80 です。
外部からアクセスする際のベースとなる HTTP パス(文字列、通常は "/")を指定します。
・"ssh":
"shell": "/bin/sh",
"host_name": "my-nginx-ssh",
"port": 0
とします。
host_name は適当です。
・"plan": "v100-32gb"
プランは "v100-32gb" にしました。
ID0=$(・・・ | jq -r '.id')
よくわからないコマンドが出てきました。
jq コマンドを使うと特定のキーだけを抽出することができます。
結果として取得した JSON データの中の id キーのみを取り出して ID0 に代入してくれます。
jq の出力は"鈴木"のようにクォート付きで返ってきます。
シェル変数に代入したいときやファイル名として使いたいときに困ります。
-r オプションを付けるとクォートを外して生の文字列を返してくれます。
bash ファイルにまとめると下記のようになります。
#!/bin/bash
ID0=$(curl -u "$SACS_TK:$SACS_S" \
-X POST "$ISI_URL_T" \
-H "Content-Type: application/json" \
-d '{
"name": "my-nginx-api",
"containers": [
{
"image": "d-nginx-yama.sakuracr.jp/my-nginx:latest",
"registry": "52ef****-069b-****-b679-18d1****4206",
"http": {
"port": 80,
"path": "/"
},
"ssh": {
"shell": "/bin/sh",
"host_name": "my-nginx-ssh",
"port": 0
},
"plan": "v100-32gb",
}]
}' | jq -r '.id')
echo "$ID0"
API から https パス を取得
ここまでで、my-nginx-api が API から起動します。
API から https パス を取得します。
3秒以内ぐらいでコンテナの状態が実行中になります。
HTTP URL を取得します。
\https://secure.sakura.ad.jp/cloud/zone/ is1a/api/managed-container/1.0/tasks/{taskId}/
の '.http_uri' に https パスが格納されています。
書式は
curl -u "{アクセストークン}:{アクセストークンシークレット}" \
-H "Content-Type: application/json" \
-X GET \https://secure.sakura.ad.jp/cloud/zone/is1a/api/managed-container/1.0/tasks/{taskId}/
です。
{アクセストークン}は $SACS_TK
{アクセストークンシークレット}は $SACS_S
取得 URL は $ISI_URL_T
taskId は $ID0
にそれぞれの値が格納されています。
そして
| jq -r '.http_uri'
で https パスを抜き取ります。
よって下記のようになります。
URL0=$(curl -u "$SACS_TK:$SACS_S" \ -H "Content-Type: application/json" \ -X GET "$ISI_URL_T"/$ID0/ | jq -r '.http_uri')
API から SSH コマンドを作成
次に ID0 と URL0 から SSH コマンドを作成します。
SSH コマンドを SSHP とすると
文字列の最初は "ssh -p 30022 "
第2文字列は ID0
第3文字列は "@"
第4文字列は URL0 の頭の8文字 https://
を削除した残りの文字列
例)
https://c72280da-d313-41c9-9e29-228b21f47c48.
1bf18867-ce9f-46ba-8c4f-36b224c34588.
container.sakurausercontent.com
です。
まとめると
URL1=${URL0:8}
SSHP="ssh -p 30022 "$ID0"@"$URL1
になります。
引き続き、ここまで説明してきた内容をまとめます。





