DevOps 変更速度管理 への Bitbucket のオンボーディング - ワークスペース
DevOps 変更速度管理ワークスペースを使用して、Bitbucketインスタンスを作成、接続、検出、および構成します。
始める前に
DevOps 変更速度管理 の使用を開始するにはトピックで指定されたタスクを完了します。
必要なロール: sn_devops.admin または sn_devops.tool_owner
手順
-
移動先 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用してプレイブックを開き、 Bitbucketをオンボーディングします。
オプション ステップ ホームページ - [ツールを接続] を選択します。
- [ツールに接続] モーダルで、[コード] カテゴリから [ Bitbucket ] を選択します。
アプリケーションモジュール - プライマリナビゲーションから [アプリケーション] (
) を選択します。
- 既存のアプリケーションを選択するか、新規作成します。アプリケーションを作成する場合は、アプリケーションを作成 - ワークスペース を参照します。
- [推奨アクション] ペインから、[ ツールの接続 ] カードを選択します。
- [ツールに接続] モーダルで、[コード] カテゴリから [ Bitbucket ] を選択します。
ツールモジュール - プライマリナビゲーションから [ツール ] (
を選択します。
- [機能] リストから [コーディング] を選択します。
- [ツールを接続] を選択します。
- [ツールに接続] モーダルで、[ Bitbucket] を選択します。
重要:ツールへの接続中にリポジトリなどのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。 -
[プラットフォーム] ドロップダウンから [Bitbucket クラウド ] または [BitBucket サーバー ] を選択し、[ ツール名 ] フィールドにツールの名前を入力して 、[次へ] を選択します。
-
Bitbucketインスタンスの詳細プレイブックアクティビティで、次の詳細を入力します。
ツール ステップ Bitbucket サーバー - Bitbucket インスタンスの URL を入力します。
- Bitbucket インスタンスのグローバル管理者のログイン資格情報を入力します。
- Bitbucket インスタンスが MID サーバーに接続されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください。
Bitbucket クラウド - 次のいずれかの認証情報タイプを選択します。
- 基本認証
- アクセストークン
- OAuth 2.0:認証コード
- OAuth 2.0 - クライアント認証情報
- 選択した認証情報タイプに基づいて、次の手順を実行します。 ベーシック認証の場合、
- [Bitbucket クラウドユーザー名] フィールドに値を入力します。
- [ パスワード] フィールドに値を入力します。注:基本認証情報の作成の詳細については、「 BitbucketとDevOps 変更速度管理との統合」を参照してください。
アクセストークンの場合、- [ アクセストークン] フィールドに値を入力します。
- [ ワークスペース ID ] フィールドに Bitbucket クラウドワークスペースの一意の識別子を入力します。
OAuth 2.0 - 認証コードの場合- 既存の認証情報レコードがある場合は、[ 認証情報] フィールドに値を入力します。
- 作成されていない場合は、 Bitbucket Cloud の OAuth 2.0 認証コードの設定 トピックで指定された手順を実行して認証情報を作成します。
OAuth 2.0 - クライアント認証情報の場合- OAuth 認証情報レコードを既に作成している場合は、[ 既存の OAuth 認証情報レコードを使用 ] オプションを選択し、[ 認証情報] フィールドで必要な認証情報レコードを選択します。そうでない場合は、次の手順に進みます。
- [ クライアント ID ] フィールドと [クライアントシークレット] フィールドに値を入力します。注:クライアント ID とクライアントシークレットの値は、Bitbucket アカウントから取得できます。Bitbucket ツールのクライアント ID は、Bitbucket クラウドの [ キー ] フィールドにあるワークスペース設定の [OAuth コンシューマー] セクションで使用できます。Bitbucket ツールのクライアントシークレットは、Bitbucket クラウドの [シークレット] フィールドのワークスペース設定の [OAuth コンシューマー] セクションで使用できます。詳細については、「BitbucketとDevOps 変更速度管理との統合」を参照してください。
- Bitbucket インスタンスが MID サーバーに接続されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください。
- [接続] を選択します。
-
入力した認証情報に対して権限チェックが実行されます。
必要な権限と利用可能な権限が表示されます。より適切なアクセス許可を持つ認証情報を入力する場合は、[認証情報を再入力] を選択します。必要なすべての権限の詳細については、「DevOps ツールに必要な権限 の Bitbucket 権限」を参照してください。
必要なすべての権限がない場合でも、ツール接続を続行することを選択できます。
- [次へ] を選択します。
-
ツールのアクセス権を指定します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。
- DevOps ツールオーナーロール: ツールを表示および編集できます。
- DevOps アプリオーナーロール: ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
- DevOps 管理者ロール: すべてのツールを編集できます。
- その他の DevOps ロール: ツールを表示できます。
注:グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。 - ツールへのアクセスを制御することを選択した場合、 すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる オプションが選択可能になります。
このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプラインステップの変更 (該当する場合) が可能になります。
- [アサイン] を選択します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
-
Webhook を自動的に構成するリポジトリを選択します。
リアルタイム通知は、特に変更要求の自動化において、最新の情報を維持するために最適です。
Webhook を手動で構成して設定することもできます。または、[ ポーリングを有効にする ] プロパティを [はい] に設定することで、夜間のポーリングを有効にして、追跡されたリポジトリのデータ システムをフェッチすることもできます。
-
[構成] を選択します。
手動で構成するには、[ 手動で構成] を選択します。詳細については、「Webhook をBitbucket で手動で構成」を参照してください。
重要:- ホームページまたはツールモジュールから接続している場合は、接続が完了し、[概要] ページに移動します。
- アプリケーションモジュールから接続している場合は、インスタンスで利用可能なリポジトリが検出されます。それらから履歴データを追跡してインポートできます。
- アプリケーションに関連付けるリポジトリを選択し、 [リポジトリの関連付け] を選択します。
-
[履歴データのインポート] ステップで、[ 開始日 ] フィールドと [終了日 ] フィールドで日付範囲を選択し、[ データのインポート] を選択します。
注:最大 90 日間のデータをインポートできます。リポジトリからインポートされたコミット、分岐、およびプル要求レコードは、対応する関連リストに追加されます。
- [次へ] を選択します。
-
[ サマリー ] ページで、正常に接続された Bitbucket ツールの詳細を確認します。
[ ツールレコードの表示 ] を選択して、接続されたインスタンスとそこから検出されたリポジトリの詳細を確認します。
タスクの結果
Bitbucket ツールが DevOps 変更速度管理 に正常にオンボーディングされました。
注:
ツールの認証情報が変更された場合は、 DevOps 変更の認証情報も更新する必要があります。詳細については、「DevOps 変更速度管理でのサードパーティツール認証情報の更新」を参照してください。