커넥터

Workflows에서 게시되는 커넥터를 사용하면 워크플로 내에서 다른 Google Cloud 제품에 더 쉽게 액세스할 수 있습니다. 사용 가능한 커넥터에 대한 자세한 내용은 커넥터 참조를 확인하세요. 커넥터 사용 방법을 보여주는 워크플로 샘플은 커넥터 샘플을 참조하세요.

커넥터를 사용하면 워크플로 내에서 다른 Google Cloud API에 연결할 수 있으므로, 워크플로를 다른 Google Cloud 제품과 쉽게 통합할 수 있습니다. 예를 들어 커넥터를 사용하여 Pub/Sub 메시지를 게시하거나, Firestore 데이터베이스에 대해 데이터 읽기 또는 쓰기를 수행하거나, Secret Manager에서 인증 키를 검색할 수 있습니다.

인증

커넥터는 기본 제공되는 Identity and Access Management 인증을 사용하여 다른 Google Cloud 제품과 상호작용합니다. 커넥터를 사용하는 워크플로가 특정 API에 올바르게 인증되기 위해서는 해당 서비스 계정에 적절한 권한이 할당되어 있어야 합니다. 예를 들어 Pub/Sub에 메시지를 게시하려면 워크플로와 연결된 서비스 계정에 roles/pubsub.publisher 역할을 부여해야 합니다. 다른 Google Cloud 제품 인증에 대해 자세히 알아보려면 워크플로 내에서 인증된 요청 수행을 참조하세요.

재시도 및 장기 실행 작업 중 동작

커넥터에는 재시도 및 장기 실행 작업 처리를 위한 기본 제공 동작이 설정되어 있습니다.

재시도

모든 커넥터는 다음과 같은 재시도 정책 및 오류 처리 구성을 적용합니다.

장기 실행 작업

장기 실행 작업을 수행하는 호출에는 다음 동작이 적용됩니다.

  • Workflows는 작업이 완료되거나 실패할 때까지 워크플로 실행을 차단합니다.

  • 호출 제한 시간은 30분입니다.

  • 커넥터는 장기 실행 작업을 주기적으로 폴링합니다. Workflows는 폴링할 때 1.25의 지수 백오프를 사용합니다. 1초부터 시작하여 폴링 간격 사이에 60초까지 느려집니다. 각 폴링 시도는 청구 가능한 단계로 계산됩니다.

  • 장기 실행 작업 중에 오류가 발생하면 Workflows가 OperationError 오류를 일으킵니다. 이 오류에는 작업별 세부정보가 있는 추가 속성 error가 포함됩니다.

Firestore

Firestore 커넥터를 사용하면 워크플로 내에서 Firestore API에 연결할 수 있습니다.

Firestore 커넥터는 기본 모드로 생성된 데이터베이스만 지원합니다. Datastore 모드의 데이터베이스에 사용될 경우에는 작업이 실패합니다. 기본 모드와 Datastore 모드의 차이점에 대해 자세히 알아보려면 기본 모드와 Datastore 모드 중 선택을 참조하세요.