Control Room でのリモート Git リポジトリの構成

Control Room でリモート Git リポジトリを構成して、すべての Bot とその依存関係をバージョン管理し、Git リポジトリに保存できるようにします。に加えて、ローカル Automation 360 のリポジトリに加え Control Room に加えて、リモートの Git は Bot とその依存関係のバックアップを提供します。

前提条件

  • Control Room でリモート Git リポジトリを構成するには、AAE_Admin ロールが割り当てられている必要があります。
  • 地域に基づいて、ネットワーク ファイアウォールを設定して、発信 NAT ゲートウェイ IP アドレスを許可されたリストに追加します。

    外部統合の Control Room IP アドレス

リモート Git リポジトリを構成している場合は、次の点に留意してください。
  • Git リポジトリは、他の Git クライアントではなく、Control Room への書き込みアクセスだけを持つように構成する必要があります。
  • Git リポジトリには、100MB を超えるファイルをアップロードすることはできません。
  • 空の Git リポジトリと統合してください。
  • 他のユーザーや製品、アプリケーションから Git リポジトリに手動でファイルをチェックインしないでください。
  • Git と統合する場合、リポジトリには ReadMe.md ファイルを含めないでください。
  • Git リポジトリが非公開 (内部) であることを確認してください。セキュリティ上の理由から、Automation 360 は公開 Git リポジトリに接続することはできません。これは、公開 Git リポジトリでは一般的に、すべての Bot とファイルがアクセス可能であるためです。

手順

  1. Control Room で [管理] > [設定] > [リモート Git リポジトリ統合] に移動します。
  2. [編集] をクリックします。
  3. 以下の認証方法のいずれかを選択し、対応する手順を実行して、Git の設定を行います。
    認証方法ステップ
    HTTPS 認証
    1. 次の形式のユーザー名を含む HTTPS リポジトリ パスを入力します。

      https://<username>@bitbucket.org/companyname/product.git

      注: Git リポジトリ アドレスを取得する Git ホストを使用します。
    2. ブランチ名を入力します。

      変更は、選択したブランチにプッシュされます。デフォルトでは、マスター ブランチが選択されます。

      ブランチ名には小文字を使用することができますが、250 文字以内にする必要があります。ブランチ名には、スペース、チルダ、コロンなどの ASCII 制御文字を含めないでください。ハイフンを使って単語を区切ることができます。ブランチ名の詳細については、「新しい Git ブランチを作成する」を参照してください。

    3. Git リポジトリのパスワード、または生成された Git トークンを入力します。
      注:
      • トークンの長さは 75 文字以内にする必要があります。
      • リポジトリ接続のために生成されたパスワードを入力する必要があります。トークンはパスワードよりも安全性が高いので、トークンを使用することをお勧めします。
      • GitHub の場合は、個人用アクセス トークン (クラシック) のみを使用する必要があります。GitHub では個人用アクセス トークン (fine-grained) は使えません。
      • BitButcket については、アプリのパスワードのみを使用する必要があります。
    4. 確認のために、パスワードまたは Git トークンを再入力します。
    SSH 認証
    1. 次の形式で、SSH リポジトリ パスを入力します。

      https://git@bitbucket.org:companyname/product.git

      注: Git リポジトリ アドレスを取得する Git ホストを使用します。
    2. ブランチ名を入力します。

      変更は、選択したブランチにプッシュされます。デフォルトでは、マスター ブランチが選択されます。

      ブランチ名には小文字を使用することができますが、250 文字以内にする必要があります。ブランチ名には、スペース、チルダ、コロンなどの ASCII 制御文字を含めないでください。ハイフンを使って単語を区切ることができます。ブランチ名の詳細については、「新しい Git ブランチを作成する」を参照してください。

    3. SSH 認証のプライベート キーを入力します。

      プライベート キーとパブリック キーのペアは、RSA アルゴリズムを使って作成する必要があります。

      注: Control Room に入力したプライベート キーに次の文字列が含まれていることを確認してください。-----BEGIN RSA PRIVATE KEY----- AND -----END RSA PRIVATE KEY-----

      パブリック キーを生成して、Git サーバーに入力する必要があります。

      お使いのサーバーに応じたパブリック キーの生成手順については、以下のトピックを参照してください。
    4. 任意: パスフレーズを入力します。
  4. オプション: [プロキシ経由で Git に接続する] のチェックボックスを選択します。
    1. プロキシのホスト名または IP アドレスを入力します。
    2. ポート番号を入力します。
    3. オプション: 認証のチェック ボックスを選択し、ユーザー名とパスワードを入力します。
  5. [接続および保存] をクリックします。
    Control Room は、リモート Git リポジトリに接続し、次のメッセージが表示されます。Git 統合の設定が正常に保存されました。[Git 設定の設定] のステータスが成功として表示される監査ログを確認することもできます。
注:
  • 公開ワークスペースの Git フォルダーに多くの Bot ファイルがある場合、チェックイン操作に時間がかかる場合があります。これは、リポジトリのサイズが大きくなると、git コミットの速度が遅くなるからです。ベスト プラクティスとしては、使用しない Bot ファイルを公開ワークスペースから削除することをお勧めします。
  • Git リポジトリに index.lock や master.lock などのロック ファイルがある場合、チェックインやチェックアウトの操作に支障をきたす恐れがあるため、これらのロック ファイルを削除してください。

Control Room では、別のユーザー名で同じ Git リポジトリに接続できます。詳細については、「Control Room でリモート Git リポジトリのユーザー名を変更する方法 (A-People のログインが必要)」を参照してください。

Git の概要については、次のビデオをご覧ください。