クイックスタート

[更新日：2025年2月21日]

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

前提条件

さくらのクラウドのアカウントが必要です。
- アカウントをお持ちでない方はさくらのクラウドのご利用開始手順から作成してください。
Dockerがインストールされた開発環境が必要です。
- Dockerの基本知識をお持ちでない方は、以下の記事で学ぶことをおすすめします。
- Docker入門（第一回）～Dockerとは何か、何が良いのか～

セットアップ 

サンプルアプリケーションの作成 

作業用ディレクトリを作成します。
```
mkdir my-app
cd my-app
```

アプリケーションファイルを作成します。

package.json

{
  "name": "my-app",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.2"
  }
}

app.js

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello from AppRun!');
});

app.listen(8080, () => {
  console.log('Server is running on port 8080');
});

Dockerfileを作成します。

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 8080
CMD ["node", "app.js"]

ディレクトリ構成を確認します。

ls -la

# 以下のファイルが存在することを確認
# - Dockerfile
# - app.js
# - package.json

AppRunへアクセス 

さくらのクラウドへログインします。
1. さくらのクラウドにアクセス
2. 会員IDまたはクラウドユーザーでログイン
重要
- 会員IDでログインする場合：全ての操作が可能です。
- クラウドユーザーでログインする場合：AppRun βの権限が付与されている必要があります。
- 権限の設定方法についてはアクセスレベルをご参照ください。
クラウドアカウントを選択します。
1. 「さくらのクラウドホーム」画面で利用するアカウントを選択
AppRunへアクセスします
1. さくらのクラウドホームのメニューから「 AppRun β 」を選択

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

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

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

コンテナレジストリの詳細な操作方法についてはコンテナレジストリをご参照ください。
コンテナイメージのビルドとプッシュを行います。

重要

Appleシリコンを搭載したMacを使用してコンテナイメージをビルドすると、AppRunへのデプロイに失敗することがあります。詳細ついてはよくある質問をご参照ください。
```
# イメージのビルド
docker build -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へアクセスします。
1. さくらのクラウドホームのメニューから「 AppRun β 」を選択
2. 「アプリケーションを作成」をクリック
アプリケーションの設定を行います。
1. アプリケーション名：任意の名前を入力（例：my-app）
2. ポート設定：8080
3. 自動スケーリング：1（デフォルト）
4. リクエスト：300 Seconds（デフォルト）
コンテナの構成情報の設定を行います。
1. コンテナイメージ：イメージ名を入力（例：my-app.sakuracr.jp/my-app:latest）
2. コンテナレジストリアクセス設定：
  1. ユーザー名：レジストリに設定したユーザー名を入力
  2. パスワード：レジストリに設定したパスワードを入力
3. リソース：
  1. メモリー：512MiB（デフォルト）
  2. vCPU：1（デフォルト）
4. 構成名：任意の名前を入力（デフォルトは自動入力）
注釈

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

動作確認 

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

クイックスタート

セットアップ

サンプルアプリケーションの作成

AppRunへアクセス

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

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

アプリケーション作成

動作確認

セットアップ 

サンプルアプリケーションの作成 

AppRunへアクセス 

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

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

アプリケーション作成 

動作確認 