DevOps チェンジベロシティ への Bitbucket のオンボーディング - ワークスペース

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:5分
  • DevOps 変更ワークスペースプレイブックを使用して Bitbucket インスタンスに接続し、リポジトリを検出します。

    始める前に

    DevOps チェンジベロシティの開始トピックで指定されたタスクを完了します。

    必要なロール:sn_devops.admin または sn_devops.tool_owner

    手順

    1. 移動先 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用してプレイブックを開き、 Bitbucketオンボーディングします。
      オプションステップ
      ホームページ
      1. [ ツールを接続] を選択します。
      2. [ツールに接続] モーダルで、[コード] カテゴリから [Bitbucket] を選択します。
      アプリケーションモジュール
      1. プライマリナビゲーションから [アプリケーション ] (アプリケーションアイコン) を選択します。
      2. 既存のアプリケーションを選択するか、アプリケーションを作成します。アプリケーションを作成するには、「 アプリケーションの作成 - ワークスペース」を参照してください。
      3. [推奨アクション] ペインから、[ ツールの接続 ] カードを選択します。
      4. [ツールに接続] モーダルで、[コード] カテゴリから [Bitbucket] を選択します。
      ツールモジュール
      1. プライマリナビゲーションから [ツール ] ([ツール] アイコン) を選択します。
      2. [機能] リストから [ コーディング] を選択します。
      3. [ ツールを接続] を選択します。
      4. [ツールに接続] モーダルで、[ Bitbucket] を選択します。
      重要:
      ツールへの接続中にリポジトリなどのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。
    2. [ツール名] フィールドにツールの名前を指定し、[次へ] を選択します。

      Bitbucket ツール画面に接続する

    3. Bitbucketインスタンス詳細プレイブックアクティビティで、次の操作を行います。
      1. Bitbucket インスタンスの URL を入力します。
      2. Bitbucket インスタンスのグローバル管理者のログイン資格情報を入力します。
      3. Bitbucketインスタンスが MID サーバーに接続されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「 MID サーバーの選択」を参照してください。
    4. [接続] を選択します。

      Bitbucket ツールに接続 - インスタンスの詳細入力画面

    5. 入力した認証情報に対して権限チェックが実行されます。

      必要な権限と利用可能な権限が表示されます。より適切なアクセス許可を持つ資格情報を入力する場合は、 [ 資格情報の再入力] を選択します。必要なすべての権限の詳細については、「DevOpsツールに必要な権限Bitbucket権限」を参照してください。

      必要なすべての権限がない場合でも、ツール接続を続行することを選択できます。

      Bitbucket ツールに接続 - 権限確認画面

    6. [Next (次へ)] をクリックします。
    7. ツールのアクセス権を指定します。
      1. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
        グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。
        • DevOps ツールオーナーロール:ツールを表示および編集できます。
        • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
        • DevOps 管理者ロール:すべてのツールを編集できます。
        • その他の DevOps ロール:ツールを表示できます。
        注:
        グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。
      2. ツールへのアクセスを制御することを選択した場合は、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ]オプションを選択できるようになります。

        このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプライン ステップの変更 (該当する場合) が可能になります。

      3. [アサイン] を選択します。

      ツールアクセスを指定します。

    8. Webhook を自動的に構成するリポジトリを選択します。

      リアルタイム通知は、特に変更要求を自動化する場合に最新の情報を維持するのに理想的です。

      Webhook を手動で構成して設定することもできます。または、「 ポーリングの有効化」 プロパティーを 「はい」に設定することで、夜間ポーリングを有効にして、追跡対象リポジトリーのデータ・システムをフェッチすることもできます。

    9. [構成] を選択します。
      Bitbucket ツールに接続 - 構成するアイテムを選択画面

      手動で構成するには、 [ 手動構成] を選択します。詳細については、「Bitbucket での Webhook の手動構成」を参照してください。

      重要:
      • ホームページまたはツールモジュールから接続している場合は、接続が完了し、[概要] ページに移動します。
      • アプリケーションモジュールから接続している場合は、インスタンスで利用可能なリポジトリが検出されます。それらから履歴データを追跡してインポートできます。
    10. [プレイブックアクティビティ を追跡するリポジトリを選択 (Select repositories to track playbook)] アクティビティから追跡してアプリケーションに関連付けるリポジトリを選択します。

      Bitbucket ツールに接続 - [追跡するリポジトリを選択] 画面

    11. [Next (次へ)] をクリックします。
    12. [ 概要] ページで、正常に接続された Bitbucket ツールの詳細を確認します。

      [ ツールレコードを表示 ] を選択して、接続されたインスタンスとそこから検出されたリポジトリの詳細を確認します。

      接続サマリー

    タスクの結果

    Bitbucket ツールが正常にオンボーディングされてDevOps チェンジベロシティされました。
    注:
    ツール認証情報が変更された場合は、 DevOps 変更認証情報も更新する必要があります。詳細については、「でのサードパーティツール認証情報の更新 DevOps チェンジベロシティ」を参照してください。