単一サーバーに Azure DevOps をオンプレミスにインストールする
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Azure DevOps Server を設定する最も簡単な方法は、すべてを 1 つのサーバーに配置することです。 この構成がチームに適していることを確認するには、 hardware の推奨事項を参照してください。 そうでない場合は、代わりに ual-server または multiple-server 構成を検討してください。
以前のバージョンからアップグレードする場合は、 互換性、 リリースノート、アップグレードの概要 の詳細をご覧ください。
Note
新しいデプロイをインストールする手順は、Azure DevOps Server のすべてのバージョンで似ています。 この記事に示されているイメージは、Azure DevOps Server 2022 または Azure DevOps Server 2019 を参照する場合があります。ただし、特に明記されていない限り、構成されている情報は同じです。
前提条件
SQL Server Express を使用する予定がない場合は、 サポートされているバージョンの SQL Server を設定します。 オンプレミスで Azure DevOps 用に SQL Server を設定する場合は、少なくとも検索機能のデータベース エンジンとフルテキスト抽出とセマンティック抽出をインストールします。
SQL Server Express は、個人用または評価版の展開にのみ使用することをお勧めします。 オンプレミスの Azure DevOps の有料コピーには、SQL Server Standard ライセンスが含まれます。 詳細については、「Azure DevOps Server の価格Team Foundation Server の価格を参照してください。 付属のライセンスを使用する場合は、それらの製品で作成されたデータベースにのみ使用できます。
インストールの構成に使用するアカウントは、SQL Server の sysadmin サーバー ロールのメンバーである必要があります。
Note
Azure DevOps をオンプレミスにインストールするには、高度な特権を必要とする複雑な一連の操作が含まれます。 これらの操作には、データベースの作成、サービス アカウントのログインのプロビジョニングなどがあります。 技術的には、必要なのは次のとおりです。
serveradmin ロールのメンバーシップ。
ALTER ANY LOGIN、CREATE ANY DATABASE、VIEW ANY DEFINITION サーバー スコープのアクセス許可。
メイン データベースに対する CONTROL 権限。
sysadmin サーバー ロールのメンバーシップは、これらすべてのメンバーシップとアクセス許可を付与します。 構成が成功することを確認する最も簡単な方法です。 必要に応じて、インストール後にこれらのメンバーシップとアクセス許可を取り消すことができます。
Search 拡張機能のインストールと構成をサポートするには、ユーザー名とパスワードを指定する必要があります。 Search のインストールと構成では、コード、作業項目、Wiki の検索機能がサポートされます。 詳細については、「 構成検索」を参照してください。 ユーザー名にハイフンや特殊文字を含めることはできません。
Note
検索には、Oracle Server JRE 8 (Update 60 以降) も必要です。 Oracle Binary Code License Agreement for Server JRE に同意し、 Configure を選択することで、最新バージョンをダウンロードしてインストールまたは更新できます。 これにより、java インストール ディレクトリを指すJAVA_HOME環境変数が設定され、Server JRE では自動更新が提供されないことに注意してください。
アプリケーション層を構成する場合は、Web サイトの設定を選択できます。 Web サイトの設定を確認して、選択肢と要件を理解します。
Management Studio のダウンロードとインストールは、
-
次のいずれかのチャネルを使用して Azure DevOps Server をダウンロードします。
- 最も簡単な方法である Visual Studio ダウンロード ([すべてのダウンロード]、[Azure DevOps Server 2019] まで下にスクロール)
- Visual Studio Dev Essentials
- ボリューム ライセンス サービス センター
インストールを開始します。
インストーラーによってファイルがコンピューターにコピーされ、Azure DevOps Server 構成センター ウィザードが開始されます。
インストールを構成するには、 ウィザードを選択するか、後で戻って、次のセクションで説明するようにサーバー構成ウィザードを起動します。
ここでは、Azure DevOps Server 2019 用に提供されるウィザードを示します
新しいデプロイの [基本] または [詳細設定] を選択する
サーバーを構成するための最初の手順は、2 つの展開オプションから選択することです。
1 台のサーバーにインストールする New Deployment - Basic シナリオを選択します。 このシナリオは、ほとんどの入力に既定のオプションを使用して、わかりやすくするために最適化されています。
New Deployment - Basic シナリオでは、次の設定を指定します。
- 言語: 構成に使用する言語を選択します。
- SQL Server インスタンス: SQL Server Express をインストールするか、既存の SQL Server インスタンスを使用するかを選択します。
- アプリケーション層: 使用する Web サイトの設定を選択します。これには、HTTP バインドと HTTPS バインドのどちらを使用するかが含まれます。 詳細については、「 Web サイトの設定」を参照してください。
- 検索: Code Search 機能をインストールして構成するか、既存の検索サービスを使用するかを選択します。 詳細については、「 構成検索」を参照してください。
すべての入力を完全に制御する場合は、 New Deployment - Advanced シナリオを選択します。
次の追加設定を指定します。
- アカウント: プロセスを実行するサービス アカウントを選択します。 Basic シナリオで使用される既定値は、ドメインに参加しているシナリオでは
NT AUTHORITY\NETWORK SERVICE
され、ワークグループ シナリオではLOCAL SERVICE
されます。 - アプリケーション層:
- [ SSH 設定で、SSH とリッスンするポートを有効にするかどうかを選択します。 基本シナリオで使用される既定値は、ポート 22 で SSH を構成することです。
- ファイル キャッシュの場所で、頻繁にアクセスされるリソースに使用されるファイル キャッシュの場所を選択します。 Basic シナリオで使用される既定値は、最も空き領域が多いローカル ドライブ上の
AzureDevOpsServerData\ApplicationTier\_fileCache
パスです。
- プロジェクト コレクション: プロジェクトの格納に使用するプロジェクト コレクションの名前を指定します。 Basic シナリオの既定の動作は、DefaultCollection という名前のプロジェクト コレクションを作成することです。
- アカウント: プロセスを実行するサービス アカウントを選択します。 Basic シナリオで使用される既定値は、ドメインに参加しているシナリオでは
NT AUTHORITY\NETWORK SERVICE
され、ワークグループ シナリオではLOCAL SERVICE
されます。 - アプリケーション層:
- [ SSH 設定で、SSH とリッスンするポートを有効にするかどうかを選択します。 基本シナリオで使用される既定値は、ポート 22 で SSH を構成することです。
- ファイル キャッシュの場所で、頻繁にアクセスされるリソースに使用されるファイル キャッシュの場所を選択します。 Basic シナリオで使用される既定値は、最も空き領域が多いローカル ドライブ上の
AzureDevOpsServerData\ApplicationTier\_fileCache
パスです。
- レポート: (省略可能) SQL Server Reporting Services を使用してレポートを作成するかどうかを選択します。 この選択をサポートするには、次の情報を指定する必要があります。
- Reporting Services インスタンス
- レポート サーバーの URL
- レポート マネージャーの URL
- SQL Server Analysis Services インスタンス
- レポート閲覧者アカウント名
- プロジェクト コレクション: プロジェクトの格納に使用するプロジェクト コレクションの名前を指定します。 Basic シナリオの既定の動作は、DefaultCollection という名前のプロジェクト コレクションを作成することです。
- アカウント: プロセスを実行するサービス アカウントを選択します。 Basic シナリオで使用される既定値は、ドメインに参加しているシナリオでは
選択内容を確認して Verify を選択すると、ウィザードによって準備チェックが実行され、環境と設定の選択が検証されます。 成功した場合は、デプロイを構成できます。 それ以外の場合は、エラーを修正し、準備チェックを再実行します。
[基本] オプションを使用して構成する
このセクションでは、サーバー構成ウィザードの [新しいデプロイ] ページで選択した Basic オプションを使用して Azure DevOps Server 構成する手順について説明します。
[Welcome] ページでオプションを選択し、[次へ] 選択。
[新しい展開] ページで、展開の種類を選択し、[次へ] を選択。
次のページで、[ 新しい展開 - 基本] を選択し、[ 次へを選択します。
Language ページで、任意の Language オプションを選択し、 Nextを選択します。
SQL サーバー インスタンスページから、使用する SQL Server インスタンスを選択します。 評価目的で、[SQL Server Express のインストール] 選択。 運用環境では、[ 既存の SQL Server インスタンスを使用するを選択します。 その後、 [次へ] を選択します。
既存の SQL Server インスタンスを使用するを選択した場合は、次のページでデータベース情報を入力し、 Testを選択して確認します。 [次へ] を選びます。
アプリケーション層 ページで、使用する Web サイト設定 (HTTP バインドと HTTPS バインドのどちらを使用するか) を選択し、次へを選択します。 詳細については、「 Web サイトの設定」を参照してください。
Search ページで、Search 機能をインストールして構成するか、既存の検索サービスを使用するかを選択します。 Search のインストールと構成では、コード、作業項目、Wiki の検索機能がサポートされます。 詳細については、「 構成検索」を参照してください。 [次へ] を選択します。
Review ページで選択内容を確認し、Verifyを選択すると、ウィザードによって準備チェックが実行され、環境と設定の選択が検証されます。 成功した場合は、デプロイを構成できます。 それ以外の場合は、エラーを修正し、準備チェックを再実行します。
準備チェック。 すべてのチェックに合格したら、構成を完了する準備が整います。 [ 構成を選択します。
ヒント
前のページに戻すには、左側のウィンドウで Previous またはページ名を選択します。 構成設定を変更する場合は、準備チェックを再実行するには、ここで Click を選択して設定を確認する必要があります。
ウィザードは Configure ページに進み、各機能の構成を開始し、進行状況を表示します。 この手順が完了するまで数分かかる場合があります。 すべての構成が成功すると、次の成功メッセージが表示されます。 [次へ] を選択します。
Complete ページで、構成の結果を確認します。 構成結果を確認し、 Copy 完全パス を選択して、構成ログ ファイルへのリンクをコピーします。 Azure DevOps Server URL リンクを選択して、構成済みのサーバーの Web ポータルに接続します。
この例では、リンクは
/http:aaronha001/
。
[詳細設定] オプションを使用して構成する
このセクションでは、 Advanced オプションを使用して Azure DevOps Server を構成する手順について説明します。
Note
Advanced オプションを使用して新しいデプロイをインストールする手順は、Azure DevOps Server および Team Foundation Server 2018 のすべてのバージョンで似ていますが、レポートは Azure DevOps Server 2022 以降のバージョンではサポートされていません。 このセクションで示すイメージは Azure DevOps Server 2019 を参照していますが、特に明記されていない限り、構成されている情報は同じです。
[Welcome] ページでオプションを選択し、[次へ] 選択。
[新しい展開] ページで、展開の種類を選択し、[次へを選択します。
次のページで、[ 新しい展開 - 詳細設定] を選択し、[ 次へを選択します。
Language ページで、任意の Language オプションを選択し、 Nextを選択します。
Database ページで、Azure DevOps Server で使用できるように設定した SQL Server インスタンスを指定します。 その後、 [次へ] を選択します。
Account ページで、使用するサービス アカウントを指定します。
アプリケーション層 ページで、使用する Web サイト設定 (HTTP バインドと HTTPS バインドのどちらを使用するか) を選択し、次へを選択します。 詳細については、「 Web サイトの設定」を参照してください。
Search ページで、Search 機能をインストールして構成するか、既存の検索サービスを使用するかを選択します。 Search のインストールと構成では、コード、作業項目、Wiki の検索機能がサポートされます。 詳細については、「 構成検索」を参照してください。 [次へ] を選択します。
レポート ページで、SQL Server Reporting Services の使用を計画していない場合、または SQL Server Analysis Services と SQL Server Reporting Services をまだインストールしていない場合は、[レポートの構成] チェック ボックスをオフにします。 それ以外の場合は、チェック ボックスをオンのままにし、[ 次へを選択します。
レポート サービス。 SQL Server Reporting Services をインストールしたサーバーの名前を入力します。 次に、[URL の入力] 選択します。 [次へ] を選択します。
Analysis Services。 SQL Server Reporting Services をインストールしたサーバーの名前を入力し、 Test を選択します。 [次へ] を選択します。
レポート閲覧者アカウント。 レポート用に設定したサービス アカウントの資格情報を入力し、 Test を選択します。 [次へ] を選択します。
[ プロジェクト コレクション ページで、 [新しいチーム プロジェクト コレクションを作成する ]チェック ボックスをオンのままにします。 プロジェクトを定義するには、少なくとも 1 つのプロジェクト コレクションが必要です。 プロジェクト名をそのまま DefaultCollectionするか、新しい名前と必要に応じて説明を付けます。
Note
プロジェクト コレクションは、Web ポータルを介したカスタマイズをサポートする継承プロセス モデルを使用するために作成されます。 後でオンプレミスの XML プロセス モデルをサポートするために、必要に応じて他のプロジェクト コレクションを作成できます。 Manage プロジェクト コレクションを参照してください。 継承プロセス モデルの詳細については、「 プロセスのカスタマイズと継承されたプロセスについてを参照してください。
Note
レポート サービスが定義されている場合、作成されたプロジェクト コレクションは、作業追跡をカスタマイズするためのオンプレミスの XML プロセス モデルをサポートします。 継承プロセス モデルを使用するコレクションを作成するには、レポート サービスで構成されていないプロジェクト コレクションを追加する必要があります。 Manage プロジェクト コレクションを参照してください。 継承プロセス モデルの詳細については、「 プロセスのカスタマイズと継承されたプロセスについてを参照してください。
Review ページで選択内容を確認し、Verifyを選択すると、ウィザードによって準備チェックが実行され、環境と設定の選択が検証されます。 成功した場合は、デプロイを構成できます。 それ以外の場合は、エラーを修正し、準備チェックを再実行します。
Readiness Checks ページから、システムは最終的なパスを実行して、構成設定が有効であることを確認します。 すべてのチェックに合格したら、構成を完了する準備が整います。 [ 構成を選択します。
ヒント
前のページに戻すには、左側のウィンドウで Previous またはページ名を選択します。 構成設定を変更する場合は、準備チェックを再実行するには、ここで Click を選択して設定を確認する必要があります。
ウィザードは Configure ページに進み、各機能の構成を開始し、進行状況を表示します。 この手順が完了するまで数分かかる場合があります。 すべての構成が成功すると、次の成功メッセージが表示されます。 [次へ] を選択します。
Complete ページで、構成の結果を確認します。 構成結果を確認し、 Copy 完全パス を選択して、構成ログ ファイルへのリンクをコピーします。 Azure DevOps Server URL リンクを選択して、構成済みのサーバーの Web ポータルに接続します。
この例では、リンクは
/http:aaronha001/
。
プロジェクトの作成
Web ポータルが開き、 プロジェクトの作成 ページが開きます。
プロジェクト名と省略可能な説明を指定します。 プロジェクト名にスペースや特殊文字を含めることはできません (例: / : \ ~ > ; @ ' " ? <> |# $ * } { , + = [ ]) は、アンダースコアで始めることはできません。ピリオドで開始または終了することはできません。また、64 文字以下にする必要があります。
既定の設定では、バージョン管理用の Git リポジトリと、作業追跡用のアジャイル プロセスが構成されます。 別のオプションを選択するには、 Advanced を展開します。
バージョン管理オプションの比較については、「 プロジェクトに適したバージョン コントロールを選択する」を参照してください。 作業追跡プロセスのレビューについては、「 プロセスの選択」を参照してください。
プロジェクトが作成されると、プロジェクトの概要ページが表示されます。 詳細については、「 プロジェクト ミッションの共有、プロジェクト アクティビティの表示を参照してください。
次のステップ
管理者の場合:
開発者向け: