クイックスタート

[更新：2026年8月5日]

AppRun共用型を使ってアプリケーションをデプロイするまでの手順を説明します。
サンプルアプリケーションを使って、基本的な流れを体験してみましょう。

前提条件

さくらのクラウドのプロジェクトが必要です。
- プロジェクトをお持ちでない方はさくらのクラウドのご利用開始手順から作成してください。
DockerおよびGitがインストールされた開発環境が必要です。
- Dockerの基本知識をお持ちでない方は、以下の記事で学ぶことをおすすめします。
- Docker入門（第一回）～Dockerとは何か、何が良いのか～
本手順では、さくらのクラウドで提供中のコンテナレジストリを使用します。
- 利用可能な外部のコンテナレジストリにつきましては、技術概要のコンポーネント制限をご参照ください。

セットアップ 

サンプルアプリケーションの準備 

注釈

サンプルイメージを利用して「サンプルアプリケーションの準備」「コンテナレジストリでの作業」の手順を省略することができます。「アプリケーション作成」で以下の情報を設定してください。

ポート設定：8080
コンテナイメージ：ghcr.io/sacloud/apprun-samples/tutorial:latest
ユーザー名、パスワード：空欄

サンプルコードを取得する。

git clone https://github.com/sacloud/apprun-samples.git
cd apprun-samples/tutorial

AppRunへアクセス 

さくらのクラウドへログインします。
1. さくらのクラウドにアクセス
2. 会員IDまたはクラウドユーザーでログイン
重要
- 会員IDでログインする場合：全ての操作が可能です。
- クラウドユーザーでログインする場合：AppRunの権限が付与されている必要があります。
- 権限の設定方法については IAMポリシーをご参照ください。
クラウドプロジェクトを選択します。
1. 「さくらのクラウドホーム」画面で利用するプロジェクトを選択
AppRunへアクセスします
1. 「さくらのクラウドホーム」の「トップ」→「クラウド/クラウド連携サービス」欄から「 AppRun共用型」を選択

コンテナレジストリでの作業 

コンテナレジストリを作成します。
1. サイドバーから「コンテナレジストリ」を選択
2. 遷移先画面で「コンテナレジストリ」が選択されていることを確認し「追加」をクリック
3. コンテナレジストリ名（例：my-app）、公開設定（非公開）を入力して作成
重要

他ユーザが作成済みの名前は使用できません。その場合は別の名前をつけてください。
レジストリユーザーを作成します。
1. 作成したレジストリを選択
2. 「ユーザー」タブをクリック
3. 「追加」をクリック
4. ユーザー名（任意）、パスワード（任意）、ユーザー権限設定（All）を設定
注釈

コンテナレジストリの詳細な操作方法についてはコンテナレジストリをご参照ください。

コンテナイメージのビルドとプッシュを行います。

# イメージのビルド
docker build --platform linux/amd64 -t my-app .

# レジストリにログイン（レジストリに設定したユーザーの認証情報を使用）
docker login my-app.sakuracr.jp

# イメージのタグ付け
docker tag my-app my-app.sakuracr.jp/my-app:latest

# イメージのプッシュ
docker push my-app.sakuracr.jp/my-app:latest

注釈

イメージのビルドが正常に完了しない場合は、Dockerの起動ができているか確認してください。
AppRun共用型はx86_64アーキテクチャで動作するため、コンテナイメージのビルドの際に linux/amd64 プラットフォームを指定してください。

アプリケーションのデプロイ 

アプリケーション作成 

AppRunへアクセスします。
1. 「さくらのクラウドホーム」の「トップ」→「クラウド/クラウド連携サービス」欄から「 AppRun共用型」を選択
2. 「アプリケーションを作成」をクリック
アプリケーションの設定を行います。
1. アプリケーション名：任意の名前を入力（例：my-app）
2. ポート設定：8080
3. オートスケーリング：
  - アプリケーション全体の最小スケール数：0（デフォルト）
  - アプリケーション全体の最大スケール数：1（デフォルト）
4. スケールの目安：100（デフォルト）
5. リクエスト：60 Seconds（デフォルト）
コンテナの構成情報の設定を行います。
1. コンテナイメージ：イメージ名を入力（例：my-app.sakuracr.jp/my-app:latest）
2. コンテナレジストリアクセス設定：
  - ユーザー名：レジストリに設定したユーザー名を入力
  - パスワード：レジストリに設定したパスワードを入力
3. リソース構成：
  - 0.5vCPU / 1GiBメモリ（デフォルト）
4. 構成名：任意の名前を入力（デフォルトは自動入力）
注釈

本クイックスタートではヘルスチェックおよび変数は入力不要で問題ありません。
パケットフィルターの設定を行います。
1. 利用設定：利用しない（デフォルト）
ログ・メトリクスの設定を行います。
1. ログ利用設定：利用しない（デフォルト）
2. メトリクス利用設定：利用しない（デフォルト）
設定内容を確認して「作成する」をクリックします。

注釈

アプリケーションの作成画面では右下に料金の目安が表示されます。

動作確認 

デプロイの完了を待ちます。
1. アプリケーション一覧でステータスが反映されるまで待機（通常1-2分程度で完了します）
2. ブラウザを更新して、ステータスが「正常」であることを確認
公開URLへアクセスします。
1. アプリケーションの詳細画面に表示される公開URLをクリック
2. ブラウザで"Hello from AppRun!"が表示されることを確認
注釈
- デプロイに失敗した場合は、コンテナイメージの指定が正しいか、ポート番号の設定が正しいかを確認してください。
- より詳しい操作方法はコントロールパネル操作ガイドをご参照ください。

クイックスタート

セットアップ

サンプルアプリケーションの準備

AppRunへアクセス

コンテナレジストリでの作業

アプリケーションのデプロイ

アプリケーション作成

動作確認