이 페이지에서는 Task Queues에서 Pub/Sub로 pull 큐 코드를 마이그레이션하는 방법을 설명합니다. Pub/Sub는 현재 App Engine에서 pull 큐 작업을 수행하는 데 선호되는 방법입니다.
앱이 pull 큐와 push 큐를 모두 사용하는 경우 push 큐를 새로운 push 큐 서비스 Cloud Tasks로 마이그레이션하기 전에 이 가이드를 사용하여 pull 큐를 Pub/Sub로 마이그레이션합니다. push 큐를 Cloud Tasks로 마이그레이션한 후 pull 큐를 마이그레이션하는 것은 권장하지 않습니다. 필수적으로 사용해야 하는 queue.yaml 파일이 Cloud Tasks에서 예기치 않게 동작할 수 있기 때문입니다.
현재 Pub/Sub에서 사용할 수 없는 기능
현재 Pub/Sub에서는 다음 Task Queues 기능을 사용할 수 없습니다.
- 태그별 일괄 처리
- 자동 중복 삭제
가격 책정 및 할당량
pull 큐를 Pub/Sub로 마이그레이션하면 앱의 가격과 할당량이 영향을 받을 수 있습니다.
가격 책정
Pub/Sub에는 자체 요금 체계가 있습니다. Task Queues의 경우처럼 Pub/Sub으로 App Engine 앱에 요청을 보내면 앱에 비용이 발생할 수 있습니다.
할당량
Pub/Sub 할당량은 Task Queues의 할당량과 다릅니다. Task Queues의 경우처럼 Pub/Sub에서 App Engine 앱으로 요청을 보내면 App Engine 요청 할당량이 영향을 받을 수 있습니다.
마이그레이션하기 전에
다음 섹션에서는 pull 큐를 Pub/Sub로 마이그레이션하기 전에 설정 단계를 설명합니다.
Pub/Sub API 사용
Pub/Sub API를 사용하도록 설정하려면 API 라이브러리에서 Pub/Sub API에서 사용 설정을 클릭합니다. 사용 설정 버튼 대신 관리 버튼이 표시되면 이전에 프로젝트에 Pub/Sub API를 사용 설정했으므로 다시 사용 설정할 필요가 없습니다.
Pub/Sub API에 앱 인증
Pub/Sub API에 앱을 인증해야 합니다. 이 섹션에서는 두 가지 사용 사례에 대한 인증을 설명합니다.
앱을 로컬로 개발하거나 테스트하려면 서비스 계정을 사용하는 것이 좋습니다. 서비스 계정을 설정하고 앱에 연결하는 방법은 수동으로 서비스 계정 사용자 인증 정보 획득 및 제공을 읽어보세요.
App Engine에 앱을 배포하기 위해 새 인증을 제공할 필요는 없습니다. 애플리케이션 기본 사용자 인증 정보(ADC)는 App Engine 앱의 인증 세부정보를 추론합니다.
Google Cloud CLI 다운로드
이전에 설치하지 않았으면 Google Cloud CLI를 다운로드하고 설치하여 Pub/Sub API에서 gcloud CLI를 사용합니다. Google Cloud CLI가 이미 설치되어 있으면 터미널에서 다음 명령어를 실행합니다.
gcloud components update
Cloud 클라이언트 라이브러리 가져오기
앱에서 클라이언트 라이브러리를 사용하려면 Pub/Sub 안내에 따라 클라이언트 라이브러리를 설치합니다.Pub/Sub 및 pull 큐
기능 비교
Pub/Sub는 게시자/구독자 관계를 통해 작업자에게 작업을 보냅니다. 구독자가 주제에서 메시지를 가져오므로 Pub/Sub의 pull 구독은 Task Queues의 pull 큐와 같습니다. 아래 표에는 Task Queues에 있는 pull 큐의 핵심 기능과 Pub/Sub의 pull 구독 관련 기능이 나와 있습니다.
| Task Queues 기능 | Pub/Sub 기능 |
|---|---|
| 대기열 | 주제 |
| 작업 | 메시지 |
| 작업자 | 구독자 |
Pub/Sub 아키텍처에 대한 자세한 내용은 Cloud Pub/Sub: Google 규모의 메시징 서비스를 참조하세요.
워크플로 비교
다음은 Task Queues에서 pull 큐의 일반적인 워크플로와 Pub/Sub의 pull 구독의 특성을 비교한 표입니다.
| Task Queues 워크플로 | Pub/Sub 워크플로 |
|---|---|
| pull 큐 만들기 | 주제를 만들고 구독자(예: 작업자)를 주제에 구독 |
| 태스크를 만들고 큐에 추가 | 메시지를 만들고 주제에 게시 |
| 작업자가 태스크를 임대 | 구독자가 주제에서 메시지를 끌어옴 |
| 작업자가 태스크 처리 | 구독자가 메시지 처리 |
| 작업자가 태스크를 큐에서 삭제 | 구독자가 메시지를 확인 |
| 임대 만료 | 모든 구독자가 메시지를 확인하면 주제가 메시지 삭제 |
Pub/Sub에서 pull 구독 만들기
Task Queues pull 큐처럼 Pub/Sub pull 구독을 사용할 수 있습니다. 주제 구독은 만료되지 않으며 여러 작업자가 동시에 사용할 수 있습니다. 즉, 작업자 두 개 이상이 메시지를 처리할 수 있으며 이는 Pub/Sub의 기본 사용 사례 중 하나입니다. Task Queues pull 큐를 Pub/Sub pull 구독으로 다시 만들려면 각 작업자의 주제를 만들고 연결된 작업자만 주제를 구독합니다. 이렇게 하면 Task Queues에서처럼 각 메시지를 정확히 작업자 하나가 처리합니다. pull 구독 만들기 및 관리에 대한 자세한 내용은 주제 및 구독 관리를 참조하세요.
pull 큐 삭제
Task Queues pull 큐를 Pub/Sub pull 구독으로 마이그레이션한 후 queue.yaml 파일을 사용하는 Task Queues에서 큐를 삭제합니다. 다음 큐를 마이그레이션하기 전에 각 pull 큐를 삭제하는 것이 좋습니다. 이렇게 하면 다른 pull 큐를 마이그레이션하는 동안 앱이 새 Pub/Sub pull 구독에서 수신하는 작업을 복제하지 않습니다. Task Queues pull 큐를 단일 배포로 삭제하지 않고 하나씩 삭제하면 App Engine 배포 할당량에 더 큰 부담을 줄 수 있습니다.
Task Queues에서 모든 pull 큐를 삭제한 후 앱의 향후 배포에서 queue.yaml 파일을 생략할 수 있습니다.
앱이 pull 큐만 사용하는 경우 코드에서 Task Queues API에 대한 참조를 삭제합니다. 앱이 pull 큐와 push 큐를 모두 사용하는 경우 pull 큐만 사용하는 파일에서 발생하는 Task Queues API에 대한 참조를 삭제하거나 push 큐도 마이그레이션할 때까지 기다린 후 모든 파일의 Task Queues API에 대한 참조를 삭제할 수 있습니다.