Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

はじめに

Liloの仕様ファイルを作成するには、次の2つが必要です:

  • SpecForgeサーバー(Docker経由)
  • VSCode拡張機能

SpecForgeサーバー

Dockerイメージ

セットアップ(1回のみ):

  1. 提供されたJSONキーをどこかに保存します。例:some_dir/key.json
  2. 作業ディレクトリで以下のコマンドを実行し、Google Artifact Registryで認証を行います:
cat key.json | docker login -u _json_key --password-stdin https://asia-northeast1-docker.pkg.dev

Dockerは今後、ImironのDockerイメージレジストリからプルするためにこのキーを使用します。

イメージの更新(必要な場合):

最新のイメージをプルするには、以下を実行します:

docker compose pull

設定

SpecForgeサーバーはポート8080で実行されます。

docker-compose.ymlでは、以下の環境変数を設定します:

  • OPENAI_KEY: https://platform.openai.com/api-keys から取得できます
- OPENAI_KEY=${OPENAI_KEY}

OpenAI APIキーを設定しない場合、SpecForgeのLLMサポートは無効になります。

アプリの実行

SpecForgeを実行するには、Docker Composeが必要です。これは、Dockerをインストールしていればほとんどの場合既に利用可能です。docker-compose.ymlが現在のディレクトリにある状態で以下を実行します:

docker compose up --abort-on-container-exit

[!NOTE] --abort-on-container-exitは、起動時のエラーでコンテナが素早く失敗するために必要です。

Visual Studio Code用SpecForge

ステップ1:Dockerコンテナが実行中であることを確認

  • SpecForgeの最新イメージをプルし、Dockerコンテナを実行します。
    • 手順については前のセクションを参照してください。

ステップ2:SpecForge用VSCode拡張機能

このフォルダにはlilo-language-X.X.X.vsixファイルが含まれています。この拡張機能をインストールするには、VSCodeの拡張機能タブまたはコマンドパレットを使用します。

拡張機能タブ

  • 拡張機能タブを開きます(Ctrl+Shift+XまたはCmd+Shift+X)
  • 右上の3つの点をクリックします
  • VSIXからインストール...を選択します

コマンドパレット

  • コマンドパレットを開きます(Ctrl+Shift+PまたはCmd+Shift+P)
  • Extensions: Install from VSIX...と入力します
  • .vsixファイルを選択します