演習 - Azure DevOps 環境を設定する

8 分

このユニットでは、このモジュールの残りの部分を完了するために、Microsoft Azure DevOps 組織が確実に設定されるようにします。

これを行うには、次を実行します。

このモジュール用の Azure DevOps プロジェクトを設定します。
変更をパイプラインにプッシュできるように、ローカルでプロジェクトが設定されていることを確認します。

Azure DevOps プロジェクトを取得する

ここでは、Azure DevOps でプロジェクトを自動で作成するテンプレートを実行することで、このモジュールの残りの部分を完了するように Azure DevOps 組織が設定されていることを確認します。

このラーニングパスのモジュールでは、Tailspin Web チームの DevOps 体験を踏襲する段階的なプロセスになっています。学習目的のために、各モジュールには Azure DevOps プロジェクトが関連付けられています。

テンプレートの実行

Azure DevOps 組織を設定するテンプレートを実行します。

Visual Studio または選択した IDE で ADOGenerator プロジェクトを取得して実行します。
テンプレートの一覧からテンプレート番号を入力するように求められたら、「Azure Pipelines で独自のビルドエージェントをホストする」に「28」と入力し、Enter キーを押します。
認証方法を選択します。個人用アクセストークン (PAT) を設定して使用することも、デバイスログインを使用することもできます。

注

PAT を設定する場合は、必ず必要なスコープを承認してください。このモジュールではフル アクセスを使用できますが、実際の状況では、必要なスコープのみを付与する必要があります。
Azure DevOps 組織名を入力し、 Enter キーを押します。
メッセージが表示されたら、Azure DevOps PAT を入力し、 Enter キーを押します。
Space Game - web - Agent などのプロジェクト名を入力し、Enter キーを押します。
プロジェクトが作成されたら、ブラウザー ( https://dev.azure.com/<your-organization-name>/) で Azure DevOps 組織に移動し、プロジェクトを選択します。

リポジトリのフォーク

まだ作成していない場合は、 mslearn-tailspin-spacegame-web リポジトリのフォークを作成します。

GitHub で、 mslearn-tailspin-spacegame-web リポジトリに移動します。
画面の右上にある [フォーク ] を選択します。
所有者として GitHub アカウントを選択し、[フォークの作成] を選択します。

重要

このモジュールの [Azure DevOps 環境のクリーンアップ ] ページには、重要なクリーンアップ手順が含まれています。クリーンアップによって、無料のビルド時間の浪費を抑えることができます。このモジュールを最後まで実行しなかったとしても、クリーンアップ手順は必ず行ってください。

プロジェクトをローカルで設定する

ここでは、Visual Studio Code で Space Game プロジェクトを読み込み、Git を構成し、リポジトリをローカルに複製して、スターターコードをダウンロードできるようにアップストリームリモートを設定します。

注

mslearn-tailspin-spacegame-web プロジェクトをローカルで既に設定している場合は、次のセクションに進むことができます。

統合ターミナルを開く

Visual Studio Code には統合ターミナルが付属しており、ファイルの編集とコマンドラインからの操作をすべて 1 か所で行うことができます。

Visual Studio Code を起動します。
[ 表示 ] メニューの [ ターミナル] を選択します。
ドロップダウンリストで、 bash を選択します。 Zsh など、慣れている Unix シェルが他にあり、そちらを使用する場合は、代わりにそのシェルを選択します。

ターミナルウィンドウでは、Bash、Zsh、PowerShell など、システムにインストールされている任意のシェルを選択できます。

ここでは、Bash を使用します。 Git for Windows には、Git コマンドを簡単に実行できる Git Bash が用意されています。

注

Windows では、 オプションとして Git Bash が表示されない場合は、 Git がインストールされていることを確認してから、Visual Studio Code を再起動します。
cd コマンドを実行して、ホームディレクトリ (~) など、作業するディレクトリに移動します。必要に応じて、別のディレクトリを選択できます。
```
cd ~
```

Git を構成する

Git と GitHub を初めて使用する場合は、最初にいくつかのコマンドを実行して、自分の ID を Git に関連付け、GitHub で認証する必要があります。

Git をセットアップすると、プロセスの詳細が説明されます。

少なくとも、次の手順を完了する必要があります。統合ターミナルから次のコマンドを実行します。

注

GitHub で既に 2 要素認証を使用している場合は、個人用アクセストークンを作成し、後でメッセージが表示されたときにパスワードの代わりにトークンを使用します。

アクセストークンは、パスワードと同様に扱います。安全な場所に保管してください。

Visual Studio Code でプロジェクトを設定する

このパートでは、フォークをローカルにクローンして、変更を加えてパイプライン構成を構築できるようにします。

注

リポジトリを複製するときにファイル名が長すぎるというエラーが発生した場合は、長い名前を持たない、または深く入れ子になっていないフォルダーでリポジトリを複製してみてください。

フォークをローカルに複製する

これで、GitHub アカウントに Space Game Web プロジェクトのコピーが作成されました。次に、コンピューターにコピーをダウンロードまたは複製して、操作できるようにします。

クローンは、フォークと同様にリポジトリのコピーです。リポジトリをクローンしたら、変更を加え、予期したとおり機能することを確認してから、それらの変更を GitHub にアップロードすることができます。ローカルコピーは、他の認証済みユーザーが、GitHub のご自分のリポジトリのコピーに対して行った変更と同期させることもできます。

Space Game Web プロジェクトをコンピューターに複製するには:

GitHub の Space Game Web プロジェクト (mslearn-tailspin-spacegame-web) のフォークに移動します。
[コード] を選択します。次に、[ HTTPS ] タブで、表示されている URL の横にあるボタンを選択して、URL をクリップボードにコピーします。
Visual Studio Code で、ターミナルウィンドウに移動します。
ターミナルで、ホームディレクトリ (~) など、作業するディレクトリに移動します。必要に応じて、別のディレクトリを選択できます。
```
cd ~
```
git clone コマンドを実行します。ここに表示されている URL をクリップボードの内容に置き換えます。
```
git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
```
mslearn-tailspin-spacegame-web ディレクトリに移動します。これはリポジトリのルートディレクトリです。
```
cd mslearn-tailspin-spacegame-web
```

アップストリームリモートを設定する

リモートは、チームメンバーが共同作業を行う Git リポジトリです (GitHub のリポジトリなど)。ここでは、リモートを一覧表示し、最新のサンプルコードを取得できるように、Microsoft のリポジトリのコピーを指すリモートを追加します。

次の git remote コマンドを実行して、自分のリモートを一覧表示します。
```
git remote -v
```
リポジトリに対してフェッチ (ダウンロード) とプッシュ (アップロード) の両方のアクセスがあることがわかります。
```
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
```
Origin では、GitHub 上のリポジトリを指定します。別のリポジトリからコードをフォークするときは、元のリモート (フォーク元のリモート) にアップストリームとして名前を付けるのが一般的です。
次の git remote add コマンドを実行して、Microsoft リポジトリを指す アップストリーム という名前のリモートを作成します。
```
git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
```

もう一度 git remote を実行して変更を確認します。

git remote -v

リポジトリに対するフェッチ (ダウンロード) とプッシュ (アップロード) の両方のアクセスがまだあることがわかります。今度は、Microsoft リポジトリへのフェッチおよびプッシュアクセスもあります。

origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)

エクスプローラーでプロジェクトを開く

Visual Studio Code では、ターミナルウィンドウは Space Game Web プロジェクトのルートディレクトリを指します。その構造を表示し、ファイルを操作するには、ファイルエクスプローラーから、ここでプロジェクトを開きます。

プロジェクトを開く最も簡単な方法は、現在のディレクトリで Visual Studio Code を再度開くことです。これを行うには、統合ターミナルから次のコマンドを実行します。
```
code -r .
```
エクスプローラーでディレクトリとファイルツリーを確認します。
統合ターミナルをもう一度開きます。ターミナルでは、ご使用の Web プロジェクトのルートに表示されます。

code コマンドが失敗した場合は、ご使用のシステム PATH に Visual Studio Code を追加する必要があります。そのためには次を行います。

Visual Studio Code で F1 キーを押すか、[ 表示>コマンドパレット ] を選択してコマンドパレットにアクセスします。
コマンドパレットで、「 シェルコマンド: PATH に 'code' コマンドをインストールする」と入力します。
前の手順を繰り返して、ファイルエクスプローラーでプロジェクトを開きます。

これで、ローカル開発環境から Space Game のソースコードと Azure Pipelines 構成を操作するように設定されました。