クイックスタート
[更新：2025年12月9日]
AppRun専有型を使ってアプリケーションをデプロイするまでの手順を説明します。
サンプルアプリケーションを使って、基本的な流れを体験してみましょう。
前提条件
さくらのクラウドの会員IDおよびプロジェクトの作成が必要です。
お持ちでない方は さくらのクラウドのご利用開始手順 から作成してください。
Dockerがインストールされた開発環境が必要です。
コンテナの用意
サンプルアプリケーションの作成からコンテナレジストリへのコンテナイメージのプッシュまでは AppRun共用型 クイックスタート セットアップ を参照してください。
サービスプリンシパルの設定
さくらのクラウド ホームの左メニューから「 サービスプリンシパル 」をクリックします。
画面右上の「サービスプリンシパルの作成」をクリックします。
「サービスプリンシパル名」に任意の名前 (例: my-app) を入力し、「作成」ボタンをクリックします。
確認画面が表示されるので、再度「作成」ボタンをクリックします。
さくらのクラウド ホームの左メニューから「 IAMポリシー 」をクリックします。
画面右上の「アクセス件の付与」をクリックします。
「プリンシパル」に作成したプリンシパル (例: my-app) を選択、「ロール」に「さくらのクラウド > 作成・削除」を選択し、「作成」ボタンをクリックします。
重要
ロールで選択するのは「AppRun」ではなく「さくらのクラウド > 作成・削除」です。
適切にロール設定がされていないと、オートスケーリンググループの設定で失敗することがあります。
確認画面が表示されるので、再度「作成」ボタンをクリックします。
注釈
詳細な設定方法については サービスプリンシパル および IAMポリシー をご参照ください。
クラスタの作成
さくらのクラウド ホームのメニューから「 AppRun専有型 」を選択し、「クラスタを追加」をクリックします。
サービスプリンシパルの選択をします。
本ページの「サービスプリンシパルの設定」で準備したサービスプリンシパル (例: my-app) を選択します。
クラスタの設定を行います。
クラスタ名: 任意の名前を入力 (例: my-app-cluster)
Let’s Encrypt利用設定: 利用しない (デフォルト)
ロードバランサの設定を行います。
待受ポート設定: 利用しない
設定内容を確認して「作成する」をクリックします。
オートスケーリンググループの作成
作成したクラスタ (例: my-app-cluster) を選択します。
「オートスケーリンググループを追加」をクリックします。
オートスケーリンググループの設定を行います。
オートスケーリンググループ名: 任意の名前を入力 (例: my-app-asg)
ゾーン: 利用したい任意のゾーンを選択 (例: 東京第1ゾーン)
ワーカノードの設定を行います。
リソース構成: 任意の構成を選択 (例: 1vCPU/2GBメモリ)
最小ノード数: 1 (デフォルト)
最大ノード数: 1 (デフォルト)
NIC設定
アップストリーム: 共有セグメント (デフォルト)
パケットフィルタ: 利用しない (デフォルト)
ロードバランサに接続する: チェックを入れない (デフォルト)
高度な設定
推奨ネームサーバ (自動設定) を利用する (デフォルト)
設定内容を確認して「作成する」をクリックします。
重要
本ページはサンプルアプリケーションを用いる前提で記載されています。実際のアプリケーションを利用し、かつ共有セグメントを使用する場合はパケットフィルタの設定を適切に行い、意図しないアクセスに注意してください。
注釈
オートスケーリンググループの作成画面では右下に利用料金の目安が表示されます。
アプリケーションの作成
クラスタのトップ画面に戻り、タブメニューから「アプリケーション」を選択します。
「アプリケーションを追加」をクリックします。
アプリケーションの作成を行います。
アプリケーション名: 任意の名前を入力 (例: my-app-sample)
設定内容を確認して「作成する」をクリックします。
「バージョンを追加」をクリックします。
コンテナの設定を行います。
コンテナイメージ: イメージ名を入力 (例: my-app.sakuracr.jp/my-app:latest)
コンテナレジストリアクセス設定
「新しいパスワードを使用する」を選択
ユーザ名: レジストリに設定したユーザ名を入力
パスワード: レジストリに設定したパスワードを入力
リソース設定
mCPU: 任意の値を入力 (例: 100)
メモリ: 任意の値を入力 (例: 128)
オートスケーリングの設定を行います。
オートスケーリング設定
「固定数のノードを維持する」を選択
ノード数: 1
ネットワークの設定を行います。
ポート設定
ターゲットポート: 8080
ロードバランサ: 利用しない (デフォルト)
ヘルスチェック: 利用しない (デフォルト)
以降は変更せず、設定内容を確認して「作成する」をクリックします。
バージョン一覧画面に戻り、右側の「…」を選択し「アクティブに変更」をクリックします。
バージョンの有効化の確認画面が表示されるので、「実行」をクリックします。
動作確認
コンテナが稼働するまで待ちます。
クラスタのトップ画面に戻り、作成したオートスケーリンググループ (例: my-app-asg) を選択します。
ワーカノード欄に表示されているIPアドレスを確認します。
ブラウザのURLバーに確認したIPアドレスを入力し、用意したアプリケーションが待ち受けるポートにアクセスします。
サンプルアプリケーションへのアクセスは8080番ポートを使用します。
(入力例) http://192.51.100.1:8080/
用意したアプリケーションにアクセスできることを確認します。
サンプルアプリケーションを使用した場合 "Hello from AppRun!" が表示されます。
注釈
より詳しい操作方法は コントロールパネル操作ガイド をご参照ください。