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에만 쓰기 액세스를 하도록 구성해야 합니다.
  • 100MB보다 큰 파일은 Git 리포지토리에 업로드할 수 없습니다.
  • 비어 있는 Git 리포지토리와 통합해야 합니다.
  • 다른 사용자, 제품 또는 애플리케이션에서 수동으로 Git 리포지토리에 파일을 체크인해서는 안 됩니다.
  • Git과 통합하는 경우, 리포지토리에 ReadMe.md 파일을 포함하지 않습니다.
  • Git 리포지토리가 비공개(내부)인지 확인하십시오. 보안상의 이유로, 모든 Automation 360 및 파일은 일반적으로 공개 Git 리포지토리에서 액세스할 수 있으므로 Bot는 공개 Git 리포지토리에 연결할 수 없습니다.

프로시저

  1. Control Room에서 관리 > 설정 > 원격 Git 리포지토리 통합으로 이동합니다.
  2. 편집을 클릭합니다.
  3. 다음 인증 방법 중 하나를 선택하고 해당 단계를 수행하여 Git 구성을 설정합니다.
    인증 방법단계
    HTTPS 인증
    1. 다음 형식으로 사용자 이름을 포함하여 HTTPS 리포지토리 경로를 입력합니다.

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

      주: Git 리포지토리 주소를 가져올 Git 호스트를 사용합니다.
    2. 브랜치 이름을 입력합니다.

      변경 내용이 선택한 브랜치로 푸시됩니다. 기본적으로 마스터 브랜치가 선택됩니다.

      브랜치 이름에 소문자를 사용할 수 있지만, 250자를 초과할 수는 없습니다. 브랜치 이름에 공백, 물결표 또는 콜론과 같은 ASCII 제어 문자를 포함하지 마십시오. 하이픈을 사용하여 단어를 구분할 수 있습니다. 브랜치 이름 설정에 대한 자세한 내용은 Create a new Git branch 항목을 참고하십시오.

    3. Git 리포지토리 비밀번호 또는 생성된 Git 토큰을 입력합니다.
      주:
      • 토큰 길이는 75자로 제한되어야 합니다.
      • 리포지토리 연결을 위해 생성된 비밀번호를 입력해야 합니다. 토큰은 비밀번호보다 안전하므로 토큰을 사용하는 것이 좋습니다.
      • GitHub의 경우 개인 액세스 토큰(클래식)만 사용해야 합니다. 개인용 액세스 토큰(세분화)은 GitHub에서 작동하지 않습니다.
      • BitButcket의 경우 앱 비밀번호만 사용해야 합니다.
    4. 비밀번호 또는 Git 토큰을 다시 입력하여 확인합니다.
    SSH 인증
    1. 다음 형식으로 SSH 리포지토리 경로를 입력합니다.

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

      주: Git 리포지토리 주소를 가져올 Git 호스트를 사용합니다.
    2. 브랜치 이름을 입력합니다.

      변경 내용이 선택한 브랜치로 푸시됩니다. 기본적으로 마스터 브랜치가 선택됩니다.

      브랜치 이름에 소문자를 사용할 수 있지만, 250자를 초과할 수는 없습니다. 브랜치 이름에 공백, 물결표 또는 콜론과 같은 ASCII 제어 문자를 포함하지 마십시오. 하이픈을 사용하여 단어를 구분할 수 있습니다. 브랜치 이름 설정에 대한 자세한 내용은 Create a new Git branch 항목을 참고하십시오.

    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 폴더에 봇 파일이 많은 경우 체크인 작업이 오래 걸릴 수 있습니다. 리포지토리 크기가 증가하면 Git 커밋 속도가 느려지기 때문입니다. 가장 좋은 방법은 공용 워크스페이스에서 사용하지 않는 봇 파일을 삭제하는 것입니다.
  • Git 리포지토리에 index.lock 또는 master.lock와 같은 잠금 파일이 있는 경우, 체크인 및 체크아웃 작업을 방해할 수 있으므로 이러한 잠금 파일을 삭제하십시오.

Control Room의 다른 사용자 이름으로 동일한 Git 리포지토리에 연결할 수 있습니다. 자세한 내용은 How to change the remote Git repository username in the control room (A-People login required) 항목을 참조하십시오.

Git에 대한 개요는 다음 비디오를 시청하십시오.