Java向け生成AIの開発環境の設定

July 2, 2026 · View on GitHub

クイックスタート: Bicep + azd を使用して数分でコードとして Azure AI Foundry にAIモデルをプロビジョニング — 詳しくは Azure AI Foundry セットアップガイドを参照してください。認証はキー不要（Microsoft Entra ID）で、APIキーの管理は不要です。

学べること

AIアプリケーション向けのJava開発環境のセットアップ
使いたい開発環境の選択と設定（Codespacesを使ったクラウド優先、ローカルの開発コンテナ、または完全なローカルセットアップ）
Azure AI Foundryモデルへの接続によるセットアップのテスト

はじめに

この章では開発環境の設定方法を説明します。本コースではモデルに Azure AI Foundry を使用します。Bicep と Azure Developer CLI（azd）でコードとしてモデルをプロビジョニングし、キー不要認証（Microsoft Entra ID）で接続します。APIキーをコピーしたり管理したりする必要はありません。

ローカルセットアップは不要です！ GitHub Codespacesを利用すればブラウザ上で完全な開発環境が利用可能で、そこからFoundryのプロビジョニングが行えます。

本コースで Azure AI Foundry を使う理由は：

コードとしてプロビジョニング可能 — 1回の azd up でアカウントとモデルの展開をデプロイ
キー不要 — AzureサインインやマネージドIDで認証
本番対応済み — 同じコードがローカルとAzureの両方で実行可能
柔軟性 — コードを変えずに展開名を変えるだけでモデルの切り替えが可能

注意: Azure AI Foundryの展開はトークン単位の従量課金（ペイ・アズ・ユー・ゴー）です。プロビジョニング、リージョン、コスト詳細については Azure AI Foundryセットアップガイドを参照してください。

ステップ1: 開発環境のセットアップ

本コース向けに事前に設定済みの開発コンテナを用意しています。セットアップ時間を短縮し必要なツールを確実に揃えられます。お好みの開発方法を選択してください：

開発環境セットアップの選択肢：

オプションA: GitHub Codespaces（推奨）

ローカルセットアップ不要、2分でコーディング開始可能！

このリポジトリをGitHubのアカウントにフォークする

注意: 基本設定を編集したい場合は Dev Container Configuration をご確認ください
Code ボタン → Codespaces タブ → ... → New with options... をクリック
デフォルトのままでOK — 本コース用に作成されたカスタムdevcontainer「Generative AI Java Development Environment」が選択されます
Create codespace をクリック
約2分待って環境が準備されるのを待つ
ステップ2: Azure AI Foundryのプロビジョニングへ進む

Codespacesの利点:

ローカルインストール不要

ブラウザがあればどのデバイスでも動作

全ツール・依存関係が事前構成済み

個人アカウントは月60時間無料

受講者全員に一貫した環境を提供

オプションB: ローカル開発コンテナ

Dockerを用いたローカル開発を好む開発者向け

このリポジトリをローカルにフォーク＆クローンする

注意: 基本設定を編集したい場合は Dev Container Configuration をご確認ください
Docker Desktop と VS Code をインストール
VS Codeに Dev Containers拡張機能をインストール
VS Codeでリポジトリフォルダーを開く
プロンプトが表示されたら Reopen in Container をクリック（または Ctrl+Shift+P → 「Dev Containers: Reopen in Container」）
コンテナのビルドと起動を待つ
ステップ2: Azure AI Foundryのプロビジョニングへ進む

Screenshot: Dev container build complete

オプションC: 既存のローカルインストールを使用

すでにJava環境を持つ開発者向け

前提条件：

Java 21+
Maven 3.9+
VS Code またはお好みのIDE

手順：

このリポジトリをローカルにクローン
IDEでプロジェクトを開く
ステップ2: Azure AI Foundryのプロビジョニングへ進む

プロのヒント: 低スペックマシンでローカルにVS Codeを使いたい場合、GitHub Codespacesがおすすめ！ローカルのVS Codeからクラウド上のCodespaceに接続して両方の利点を活用できます。

Screenshot: created local devcontainer instance

ステップ2: Azure AI Foundryのプロビジョニング

本コースのAIモデルをコードとしてAzure AI Foundryに展開します。リポジトリルートから：

cd 02-SetupDevEnvironment
azd auth login
az login
azd up

azd は環境名とリージョンを尋ね、gpt-4o-mini と text-embedding-3-small の展開を含むAzure AI Foundryアカウントをプロビジョニングし、例の .env にエンドポイントを書き込みます — すべてキー不要認証（APIキー不要）で行います。

完全な手順: 前提条件、手動（ポータル）による代替、リージョンの案内、コストやクリーンアップの注意点については Azure AI Foundryセットアップガイドを参照してください。

ステップ3: セットアップのテスト

Foundryモデルのプロビジョニングが完了したら、02-SetupDevEnvironment/examples/basic-chat-azure のサンプルアプリで接続をテストします。

開発環境内のターミナルを開く。

サンプルへ移動：

cd 02-SetupDevEnvironment/examples/basic-chat-azure

サインインしているか確認（キー不要認証にはトークンが必要）：
```
az login
```
もし azd up を実行済みなら、エンドポイントが書き込まれた .env ファイルが既にあります。
アプリケーションを実行：
```
mvn clean spring-boot:run
```

gpt-4o-mini モデルからの応答が見られるはずです。

サンプルコードの理解

examples/basic-chat-azure にあるサンプルはSpring Bootアプリで、Spring AI を使いキー不要認証でAzure AI Foundryに接続します。

このコードの内容：

Azureサインイン（Microsoft Entra ID）でAzure AI Foundryに接続（APIキー不要）
gpt-4o-mini モデルにプロンプトを送信
AIの応答を受信し表示
セットアップが正しく動作するか検証

重要な依存関係（pom.xml内）：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-azure-openai</artifactId>
</dependency>

設定ファイル（application.yml）：

spring:
  ai:
    azure:
      openai:
        # Endpoint only - no api-key. Spring AI uses DefaultAzureCredential (keyless).
        endpoint: ${AZURE_OPENAI_ENDPOINT}
        chat:
          options:
            deployment-name: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini}

まとめ

素晴らしい！これで以下がすべて整いました：

Bicep + azd でコードとしてAzure AI Foundryモデルをプロビジョニング済み
Javaの開発環境が動作中（Codespacesでもdev containerでもローカルでも）
キー不要認証（Microsoft Entra ID）でAzure AI Foundryに接続済み — APIキー不要
モデルとやり取りする簡単な例で動作確認済み

次のステップ

第3章: コア生成AI技術

トラブルシューティング

問題が発生していますか？よくある問題と解決法：

認証が失敗する（401/403）？
- az login を実行 — 認証はキー不要なのでサインインが必要
- アカウントにリソースの Cognitive Services OpenAI User ロールがあるか確認
- プロビジョニング直後はロール割当の反映に数分かかることがあります
Mavenが見つからない？
- dev container/Codespaces利用ならMavenは事前インストール済み
- ローカルセットアップの場合はJava 21+ と Maven 3.9+ がインストールされているか確認
- mvn --version でインストール状況を確認
azdが見つからない、またはプロビジョニングに失敗？
- Azure Developer CLI をインストールし azd auth login を実行
- gpt-4o-mini が利用可能なリージョンを選択（例：eastus2）
- 詳細は Azure AI Foundryセットアップガイドを参照
Dev containerが起動しない？
- Docker Desktopが起動しているか確認（ローカル開発時）
- コンテナの再ビルドを試す：Ctrl+Shift+P → 「Dev Containers: Rebuild Container」
アプリケーションのコンパイルエラー？
- 正しいディレクトリにいるか確認：02-SetupDevEnvironment/examples/basic-chat-azure
- mvn clean compile でクリーンビルドを試す

サポートが必要ですか？ 問題が解決しない場合は、リポジトリでIssueを開いてください。お手伝いします。

免責事項：本書類は AI 翻訳サービス Co-op Translator を使用して翻訳されています。正確性を期していますが、自動翻訳には誤りや不正確な部分が含まれる可能性があることをご承知おきください。原文の原語版が正式な情報源とみなされるべきです。重要な情報については、専門の人間による翻訳を推奨します。本翻訳の利用により生じたいかなる誤解や解釈違いについても、当方は責任を負いかねます。