커스텀 커넥터 버전 관리

커스텀 커넥터 버전 만들기

커스텀 커넥터 버전을 만들려면 다음 단계를 따르세요.

  1. 콘솔에서 Integration Connectors > 커스텀 커넥터 페이지로 이동한 후 Google Cloud 프로젝트를 선택하거나 만듭니다.

    커스텀 커넥터 페이지로 이동

    커스텀 커넥터 목록이 표시됩니다.

  2. 버전을 추가할 커스텀 커넥터를 클릭합니다.

    그러면 연결 세부정보 페이지가 표시됩니다.

  3. 버전을 클릭합니다.

    페이지에 모든 버전의 커넥터가 표시됩니다.

  4. 만들기를 클릭합니다. 이렇게 하면 새 버전 만들기 페이지가 새 버전 숫자와 함께 표시됩니다. 새 버전을 만드는 단계는 새 커스텀 커넥터를 만드는 단계와 유사합니다. 즉, 직접 또는 간접적으로 연결된 버전을 만들 수 있습니다.

커스텀 커넥터 버전 관리

커스텀 커넥터를 수정하려면 다음 단계를 따르세요.

  1. 콘솔에서 Integration Connectors > 커스텀 커넥터 페이지로 이동한 후 Google Cloud 프로젝트를 선택하거나 만듭니다.

    커스텀 커넥터 페이지로 이동

    커스텀 커넥터 목록이 표시됩니다.

  2. 버전이 있는 커스텀 커넥터를 클릭합니다.

    그러면 연결 세부정보 페이지가 표시됩니다.

  3. 버전을 클릭합니다.

    선택한 커넥터의 버전이 표시됩니다.

  4. 작업을 클릭하여 다음 옵션 중 하나를 선택합니다.
    • 세부정보 보기: 커스텀 커넥터 버전 세부정보를 확인합니다.
    • 버전 지원 중단: 버전을 지원 중단합니다.
    • 삭제: 버전을 삭제합니다.
    • 내보내기: 커넥터 버전을 JSON 사양 파일로 다운로드합니다. 자세한 내용은 내보내기 및 가져오기를 참조하세요.

내보내기 및 가져오기

커넥터 사양을 내보내고 가져와 여러 Google Cloud 프로젝트 간에 커넥터를 공유할 수 있습니다. 연결 버전을 내보낸 후 사양을 동일한 프로젝트 또는 다른 Google Cloud 프로젝트로 가져올 수 있습니다. 지원 중단된 커넥터 버전 내보내기는 지원되지 않습니다.

필수 역할 및 권한

커스텀 커넥터를 내보내고 가져오는 데 필요한 권한을 얻으려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.

  • Cloud Storage 버킷에 대한 스토리지 객체 관리자(roles/storage.objectAdmin)
  • 보안 비밀이 있는 프로젝트에 대한 보안 관리자(roles/iam.securityAdmin) 또는 관리자에게 보안 비밀이 있는 프로젝트에 대한 secretmanager.secrets.getIamPolicy 및 secretmanager.secrets.setIamPolicy 권한, 사용자 또는 서비스 계정을 부여해 달라고 요청할 수도 있습니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

커스텀 커넥터 내보내기

커넥터 버전을 내보내려면 다음 단계를 따르세요.

  1. 콘솔에서 Integration Connectors > 커스텀 커넥터 페이지로 이동한 후 Google Cloud 프로젝트를 선택하거나 만듭니다.

    커스텀 커넥터 페이지로 이동

  2. 내보내려는 커스텀 커넥터를 클릭합니다. 커스텀 커넥터의 개요 페이지가 열립니다.
  3. 버전을 클릭합니다. 커스텀 커넥터의 버전 목록이 표시됩니다.
  4. 추가 작업을 클릭한 후 내보내기를 클릭합니다. 커스텀 커넥터의 JSON 사양 파일이 다운로드됩니다.

커스텀 커넥터 가져오기

커넥터 버전을 가져오려면 다음 단계를 따르세요.

  1. 콘솔에서 Integration Connectors > 커스텀 커넥터 페이지로 이동한 후 Google Cloud 프로젝트를 선택하거나 만듭니다.

    커스텀 커넥터 페이지로 이동

    2. 커스텀 커넥터 페이지가 나타납니다.
  2. 가져오기를 클릭합니다.
  3. 커스텀 커넥터의 JSON 사양 파일을 찾아서 선택합니다. 커넥터를 다른 프로젝트로 가져오는 경우 서비스 계정 필드가 미리 채워지지 않습니다.

    커넥터가 이미 있는지 여부에 따라 다음 시나리오가 가능합니다.

    • 같은 이름의 커넥터가 존재하지 않음: 커스텀 커넥터 만들기 페이지가 표시됩니다. 가져온 JSON의 커넥터 버전이 미리 입력됩니다. 이 버전은 변경할 수 없습니다.
    • 동일한 이름의 커넥터가 있지만 동일한 버전이 존재하지 않음: 해당 커넥터의 버전 만들기 페이지가 표시됩니다. 커넥터 유형, 이름, 설명과 같은 커넥터 속성은 기존 커넥터에서 미리 채워지며 가져온 JSON에서 덮어쓰기되지 않습니다. 하지만 커넥터 버전 세부정보 및 이름은 가져온 JSON에서 읽습니다. 버전 이름만 수정할 수 있습니다.
    • 이름 및 버전이 동일한 커넥터가 있음: 버전이 이미 존재하며 JSON 사양을 가져올 때 새 버전이 사용된다는 경고 메시지가 표시됩니다. 가져오기를 클릭하면 해당 커넥터의 버전 만들기 페이지가 표시됩니다. 커넥터 유형, 이름, 설명과 같은 커넥터 속성은 기존 커넥터에서 미리 채워지며 가져온 JSON으로 덮어쓰기되지 않습니다. 하지만 가져온 JSON에서 버전 세부정보를 읽고 수정할 수 있습니다. 사용 가능한 최신 버전 번호가 버전 이름에 사용됩니다.
  4. 나머지 세부정보를 입력하고 만들기를 클릭합니다. 커넥터는 가져온 JSON 사양으로 생성됩니다.