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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間: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. [Connect (接続)] を選択します。

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

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

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

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

      Bitbucket ツールへの接続:権限確認画面

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

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

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

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

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

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

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

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

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

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

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

    11. [Next] を選択します。
    12. [ サマリー ] ページで、正常に接続された Bitbucket ツールの詳細を確認します。

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

      接続サマリー

    タスクの結果

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