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