演習 - Visual Studio Code と連携して動作するように GitHub Copilot を設定する
この演習では、提供された Python Web API リポジトリの Codespace を開きます。 この環境では、最初に独自のリポジトリを作成せずに実験できます。
環境のセットアップ
まず、GitHub Copilot 拡張機能があらかじめ設定された Codespaces 環境を起動します。 コードスペースを作成する前に、マシンの種類、支払い者、残りの許容量、支出コントロールを確認します。
重要
個人用GitHub無料アカウントには、毎月 120 Codespaces コア時間と 15 GB 月のストレージが含まれます。 2 コア マシンでは、他の場所でその許容量を使用していない場合、120 コア時間は 60 時間の実行時間です。 個人のGitHub Proアカウントには異なる利用枠があります。 組織およびエンタープライズプランには、無料の Codespaces クォータは含まれません。
Codespaces の課金ドキュメントでは、現在の許容量と料金について説明しています。 アカウントの設定を確認したら、環境を作成してください。
- ブラウザーで構成済みの環境のコードスペースを開きます。
- [ コードスペースの作成 ] ページで、構成設定を確認し、[ 新しいコードスペースの作成] を選択します。
- コンテナーのセットアップと拡張機能のインストールが完了するまで待ちます。 このプロセスには数分かかることがあります。
残りの演習は、この開発コンテナーで行われます。 2 つ目の環境を作成するのではなく、プロジェクト用に既に構成されているPython環境を使用します。
起動リンクにより、指定されたリポジトリに関連付けられているコードスペースが開きます。 読み取りアクセス権とフォークアクセス許可を持っている場合、Codespaces は新しいブランチをコミットまたはプッシュするときに、アカウントの下にフォークを作成またはリンクできます。 フォーク プロンプトが表示されたら、指示に従ってください。 コードスペースにのみ格納されているコミットは、GitHub 上のバックアップではありません。
GitHub Copilotを有効にする
Copilot アクセス権を持つGitHub アカウントで VS Code にサインインします。 まだアクセスできない場合は、Copilot Free を有効にするか、組織が提供する対象プランを使用してください。 タイトル バーで [ チャット ] を選択し、[ チャットを開く] を選択し、続行する前に要求を送信できることを確認します。
この演習を開始するために、有料Copilotプランを購入する必要はありません。 Copilot Free には、毎月 2,000 個のコード補完と AI クレジットの許容量を含む、限られた利用枠があります。 開始する前に、現在の許容量を確認してください。 機能の可用性と使用状況は、アカウントと組織のポリシーによって異なります。 現在の詳細については、Copilotプランを参照してください。
検証済みの学生はGitHub Education を通じて Copilot Student をアクティブ化できます。 検証済みの教師と、人気のあるオープンソース プロジェクトの資格のある保守担当者は、Copilot Pro を無償で利用できる場合があります。 適格性とアクティブ化の要件は異なります。
Python Web API を実行する
コンテナーは、設定済みのPython環境にプロジェクトの依存関係をインストールします。 コードスペースにアタッチすると、構成されたスタートアップ コマンドによって、ポート 8000 で Uvicorn が自動再読み込みで実行されます。
- スタートアップ ターミナルで、アプリケーションの起動が成功したことを確認します。 エラーが表示された場合は、続行する前に解決してください。 ポート エントリだけでは、アプリケーションが実行されていることが証明されません。
- [ポート] ビューを開き、Application というラベルの付いたポート 8000 を見つけます。
- ブラウザーでそのポートを開き、その公開設定を プライベート のままにします。 アプリケーションのルートは、
/docsにある対話型 API ドキュメントにリダイレクトされます。
通常、サーバーは既に実行されています。 ポート 8000 で 2 つ目のコピーを開始しないでください。 保存されたPythonの変更により、設定された再読み込みがトリガーされます。 サーバーを手動で再起動する必要がある場合は、別のコピーを開始する前に、実行しているターミナルで Ctrl + C キー を押して既存のプロセスを停止します。
前のサーバーが停止したら、Codespace のリポジトリ ルートから次の回復コマンドを実行します。
/home/vscode/venv/bin/python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload
ブラウザーでは、自分のコンピューターの localhost:8000 ではなく、転送先のアプリケーション URL を使用します。 詳細については、 コードスペース内のポートの転送を参照してください。