チュートリアル: ソースコードから Azure Container Apps へのビルドとデプロイ

2025-02-28

この記事では、任意のプログラミング言語で、コンピューター上のソースコードから Azure Container Apps にアプリケーションをビルドしてデプロイする方法について説明します。

このチュートリアルでは、次のことを行います。

単純な Web アプリケーションを作成します。
アプリに関連付けられている Dockerfile を作成します。
コンパイル済みのコードからイメージを作成し、コンテナーレジストリにプッシュします。
マネージド ID を使用して、コンテナーレジストリに安全にアクセスします。
Azure Container Apps にコンテナーをデプロイします。
ブラウザーでアプリを表示し、デプロイを確認します。

前提条件

このプロジェクトを完了するには、次の項目が必要です:

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。続行するには、Azure サブスクリプションの "共同作成者" または "所有者" のアクセス許可が必要です。詳細については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。
Azure CLI	Azure CLI をインストールするか、最新バージョンにアップグレードします。 Azure Developer CLI (`azd` コマンド) は、Azure CLI から使用できます。

言語の選択によっては、適切なランタイム、SDK、およびその他の依存関係のインストールが必要になる場合もあります。

.NET SDK をインストールします。

ローカルアプリケーションを作成する

次の手順では、Azure Container Apps にデプロイするサンプルアプリケーションをビルドするために必要なコードと依存関係を示します。

Note

表示されている言語以外の別の言語を使用する場合は、次のプロンプトを希望の AI モデルに入力します。

プロンプトを送信する前に、<LANGUAGE> を選択した言語に置き換えます。

Generate the simplest possible "hello world" web server in idiomatic <LANGUAGE>.

Make sure to include any dependencies required for the application to run locally and in production.

ソースコードを作成して実行します。
- C#
- Java
- JavaScript
- Python
新しい C# プロジェクトを作成します。
```
dotnet new webapp --name MyAcaDemo --language C#
```
MyAcaDemo フォルダーに移動します。
```
cd MyAcaDemo
```
コードエディターで Program.cs を開き、内容を次のコードに置き換えます。
```
public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
                webBuilder.UseUrls("http://*:8080");
            });
}
```
このコードを使用して Program クラスを実装すると、Web アプリケーションの基礎が作成されます。次に、Web ページを応答として返すクラスを作成します。

同じフォルダーに、Startup.cs という名前の新しいファイルを作成し、次のコードを入力します。
```
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
    }

    public void Configure(IApplicationBuilder app)
    {   
        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapGet("/", async context =>
            {
                await context.Response.WriteAsync("Hello World!");
            });
        });
    }
}
```
Web アプリケーションに要求が行われると、"Hello World!" というテキストが返されます。ローカルコンピューターでコードが正しく実行されていることを確認するには、リリース構成でプロジェクトをビルドします。
```
dotnet build -c Release
```
次に、アプリケーションを実行して、コードが正しく実装されていることを確認します。
```
dotnet run --configuration Release
```
次のコマンドを使用して、最初に Spring Boot スターターアプリケーションをフェッチして、新しい Java アプリケーションを作成します。
```
curl https://start.spring.io/starter.zip -d dependencies=web -d name=MyAcaDemo -d artifactId=MyAcaDemo -d baseDir=MyAcaDemo -o MyAcaDemo.zip
```
unzip コマンドがインストールされていない場合は、今すぐインストールできます。
```
sudo apt-get update && sudo apt-get install unzip
```
これで、パッケージを MyAcaDemo という名前のフォルダーに解凍できます。
```
unzip MyAcaDemo.zip -d MyAcaDemo
```
このパッケージを解凍すると、MyAcaDemo という名前のフォルダーが MyAcaDemo という名前の外部フォルダー内に存在する、入れ子になったフォルダー構造が作成されます。

次のコマンドを使用して、正しい MyAcaDemo フォルダーに移動します。
```
cd MyAcaDemo/MyAcaDemo
```
コードエディターでこのフォルダーを開き、一部のファイルを追加および編集できるようにします。

src/main/java/com/example/MyAcaDemo/ フォルダーに、MyAcaDemoController.java という名前のファイルを作成し、次のコードを入力します。
```
package com.example.MyAcaDemo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class MyAcaDemoController {
    @GetMapping("/")
    public String hello() {
        return "Hello, World!";
    }
}
```
MyAcaDemo フォルダーに、pom.xml という名前のファイルを作成し、次のコードを追加します。
```
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>MyAcaDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>MyAcaDemo</name>
    <description>Demo project for Spring Boot</description>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.0</version>
        <relativePath/> 
    </parent>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>3.1.0</version>
            <configuration>
                <mainClass>com.example.MyAcaDemo.MyAcaDemoApplication</mainClass>
            </configuration>
        </plugin>
        </plugins>
    </build>
</project>
```
次のコマンドを実行して、プロジェクトのビルドにエラーがないか確認します。
```
mvn clean package -DskipTests
```
ビルドが正常に完了したら、次のコマンドを実行して、アプリケーションがコンピューター上で正しく実行されていることを確認します。
```
mvn spring-boot:run
```
MyAcaDemo という名前のフォルダーを作成して、デモアプリケーションのファイルを保持します。
```
mkdir MyAcaDemo
```
次に、MyAcaDemo フォルダーに移動します。
```
cd MyAcaDemo
```
次のコマンドを使用して、Node.js アプリケーションの基本ファイルを生成します。
```
npm init -y
```
コードエディターでこのフォルダーを開き、次のコードを使用して index.js という名前のファイルを作成します。
```
const http = require('http');

const server = http.createServer((req, res) => {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('<html>Hello World!</html>');
});

server.listen(8080, () => {
    console.log('Server running at http://localhost:8080/');
});
```
これで、次のコマンドを実行して、アプリケーションがコンピューター上で正しく実行されていることを確認できます。
```
node index.js
```
MyAcaDemo という名前のフォルダーを作成します。
```
mkdir MyAcaDemo
```
MyAcaDemo フォルダーに移動します。
```
cd MyAcaDemo
```
次のコマンドを使用して Flask をインストールします。
```
pip install flask
```
サンプルアプリケーションは Flask フレームワークに基づいています。アプリをクラウドにデプロイする前に、コンピューター上でアプリが正しく実行されていることを確認できるように、ローカルにインストールする必要があります。

app.py という名前のファイルを新規作成し、次のコードを入力します。
```
from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return '<html>Hello World!</html>'

if __name__ == '__main__':
    app.run()
```
このコードは、Hello World! を返す基本的な Web サーバーを作成します。

同じフォルダーに、requirements.txt という名前の新しいファイルを作成し、次のコードを入力します。
```
Flask
gunicorn
```
このファイルは、Flask Web フレームワークと gunicorn Web サーバーを使用してサンプルアプリケーションをホストするように Python ランタイムに指示します。

次のコマンドを実行して、アプリケーションが正常に動作していることを確認します。
```
python3 app.py
```
アプリケーションが期待どおりに動作することを確認したら、ローカルサーバーを停止し、Dockerfile の作成に進んで、アプリを Container Apps にデプロイできます。

MyAcaDemo フォルダーに、Dockerfile という名前のファイルを作成し、次の内容を追加します。

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY . .
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
COPY --from=build /app/publish .
EXPOSE 8080
ENTRYPOINT ["dotnet", "MyAcaDemo.dll"]

FROM maven:3.8.4-openjdk-17 AS build
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package -DskipTests

FROM openjdk:17-jdk-alpine
WORKDIR /app
COPY --from=build /app/target/MyAcaDemo-0.0.1-SNAPSHOT.jar /app/MyAcaDemo.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "MyAcaDemo.jar"]

FROM node:18
WORKDIR /usr/src/app
COPY ./ . 
RUN npm install
EXPOSE 3000
CMD ["node", "index.js"]

FROM python:3.9-slim
WORKDIR /app
COPY . /app
RUN pip install --no-cache-dir -r requirements.txt
EXPOSE 8080
ENV FLASK_APP=app.py
CMD ["gunicorn", "--bind", "0.0.0.0:8080", "app:app"]

コードと Dockerfile の準備ができたので、アプリを Azure Container Apps にデプロイできます。

Azure リソースを作成する

次のコマンドを使用して、CLI から Azure にサインインします。認証プロセスを完了するには、すべてのプロンプトに従ってください。
```
az login
```
Azure CLI 用の Azure Container Apps 拡張機能をインストールまたは更新します。
```
az extension add --name containerapp --upgrade
```
Note

az containerapp コマンドを実行するときにパラメーターが見つからないというエラーが表示された場合には、最新バージョンの Azure Container Apps 拡張機能がインストールされていることを確認してください。
Azure CLI のセットアップが完了したら、一連の環境変数を定義できます。

次のコマンドを実行する前に、指定された値を確認します。

場所は米国中部として構成されていますが、必要に応じて最も近い場所に変更できます。
```
LOCATION="CentralUS"
RESOURCE_GROUP="my-demo-group"
IDENTITY_NAME="my-demo-identity"
ENVIRONMENT="my-demo-environment"
REGISTRY_NAME="mydemoregistry$(openssl rand -hex 4)"
CONTAINER_APP_NAME="my-demo-app"
```
mydemoregistry$(openssl rand -hex 4) コマンドは、コンテナーレジストリ名として使用するランダムな文字列を生成します。レジストリ名はグローバルに一意である必要があるため、この文字列はコマンドを正常に実行するのに役立ちます。
コンテナーアプリのデプロイに関連するサービスを整理するためのリソースグループを作成します。
```
az group create \
  --name $RESOURCE_GROUP \
  --___location $LOCATION \
  --output none
```
ユーザー割り当てマネージド ID を作成し、次のコマンドを使用してその ID を取得します。

最初に、マネージド ID を作成します。
```
az identity create \
    --name $IDENTITY_NAME \
    --resource-group $RESOURCE_GROUP \
    --output none
```
次に、後で使用するために ID 識別子を変数に設定します。
```
IDENTITY_ID=$(az identity show \
  --name $IDENTITY_NAME \
  --resource-group $RESOURCE_GROUP \
  --query id \
  --output tsv)
```

次のコマンドを使用して、アプリをホストする Container Apps 環境を作成します。

az containerapp env create \
    --name $ENVIRONMENT \
    --resource-group $RESOURCE_GROUP \
    --___location $LOCATION \
    --mi-user-assigned $IDENTITY_ID \
    --output none

リソースグループに Azure Container Registry (ACR) インスタンスを作成します。レジストリにはコンテナーイメージが格納されます。
```
az acr create \
  --resource-group $RESOURCE_GROUP \
  --name $REGISTRY_NAME \
  --sku Basic \
  --output none
```
次のコマンドを使用して、ユーザー割り当てマネージド ID をコンテナーレジストリインスタンスに割り当てます。
```
az acr identity assign \
  --identities $IDENTITY_ID \
  --name $REGISTRY_NAME \
  --resource-group $RESOURCE_GROUP \
  --output none
```

イメージをビルドしてレジストリにプッシュする

次のコマンドを使用して、コンテナーイメージをビルドしてコンテナーレジストリインスタンスにプッシュします。

az acr build \
    -t $REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld" \
    -r $REGISTRY_NAME .

このコマンドは、タグ helloworld をコンテナーイメージに適用します。

コンテナーアプリを作成する

次のコマンドを使用して、コンテナーアプリをデプロイします。

az containerapp create \
  --name $CONTAINER_APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld" \
  --target-port 8080 \
  --ingress external \
  --user-assigned $IDENTITY_ID \
  --registry-identity $IDENTITY_ID \
  --registry-server $REGISTRY_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

このコマンドは、コンテナーレジストリからイメージをプルできるように、acrPull ロールをユーザー割り当てマネージド ID に追加します。

次の表で、このコマンドで使用されるパラメーターについて説明します。

パラメーター	価値	説明
`name`	`$CONTAINER_APP_NAME`	コンテナーアプリの名前。
`resource-group`	`$RESOURCE_GROUP`	コンテナーアプリがデプロイされているリソースグループ。
`environment`	`$ENVIRONMENT`	コンテナーアプリが実行される環境。
`image`	`$REGISTRY_NAME".azurecr.io/"$CONTAINER_APP_NAME":helloworld"`	レジストリ名とタグを含む、デプロイするコンテナーイメージ。
`target-port`	`80`	アプリが要求をリッスンしているポートと一致します。
`ingress`	`external`	パブリックインターネットからコンテナーアプリにアクセスできるようにします。
`user-assigned`	`$IDENTITY_ID`	コンテナーアプリのユーザー割り当てマネージド ID。
`registry-identity`	`registry-identity`	コンテナーレジストリへのアクセスに使用される ID。
`registry-server`	`$REGISTRY_NAME.azurecr.io`	コンテナーレジストリのサーバーアドレス。
`query`	`properties.configuration.ingress.fqdn`	アプリの完全修飾ドメイン名 (FQDN) のみに出力をフィルター処理します。

このコマンドが完了すると、新しい Web アプリの URL が返されます。

デプロイの確認

アプリの URL を Web ブラウザーにコピーします。コンテナーアプリを起動すると、Hello World! が返されます。

アプリケーションに初めてアクセスするため、アプリから応答が返されるまでに少し時間がかかる場合があります。

リソースをクリーンアップする

このチュートリアルで作成した Azure リソースを使用しない場合は、1 つのコマンドで削除できます。コマンドを実行する前に、このチュートリアルシリーズの次の手順で、コードに変更を加え、Azure でアプリを更新する方法を示します。

このチュートリアルで作成したすべての Azure リソースを削除する場合は、次のコマンドを使用してリソースグループを削除します。

az group delete --name aca-demo

ヒント

問題がある場合は、 GitHub の Azure Container Apps リポジトリでイシューを開いて、お知らせください。

次のステップ

次に、作成したコンテナーアプリを更新する方法を学習します。

ソースコードからデプロイされたコンテナーアプリを更新する

次の方法で共有

チュートリアル: ソース コードから Azure Container Apps へのビルドとデプロイ

前提条件

ローカル アプリケーションを作成する