빌드 알림에 dev · stage · prod 를 구분해서 표시하기

gcloud config set project aboutfishingproduct
gcloud config set account hiseo@aboutfishing.kr

Cloud Build 는 빌드 상태가 바뀔 때마다 cloud-builds 라는 Pub/Sub 토픽에 메시지를 넣는다. 그걸 누가 받아서 챗으로 보내고 있는지 찾는다.

gcloud pubsub topics list-subscriptions cloud-builds
gcloud pubsub subscriptions describe [위에서 나온 구독 이름]
gcloud run services list
gcloud functions list

구독의 pushEndpoint 에 적힌 주소가 카드를 만드는 곳이다. 둘 중 하나일 것이다.

• 직접 만든 함수나 서비스 — 카드 JSON 을 만드는 코드가 그 안에 있다. 그 코드 한 곳만 고치면 된다.
• Cloud Build 공식 notifier(cloud-build-notifiers) — Cloud Run 서비스로 떠 있고 설정 파일이 GCS 버킷에 있다. 그 설정의 filter 와 template 을 고친다.

끝난 걸 아는 법 · 카드 문구 Build Succeeded 를 검색해서 그 문자열이 있는 파일이나 코드를 찾았으면 된다.

같이 확인할 것 · 그 코드나 설정이 성공만 걸러서 보내고 있는지. status == 'SUCCESS' 같은 조건이 있으면 지금 실패 알림이 안 오고 있다는 뜻이다. 4단계에서 고친다.

이름이 아니라 빌드 구성 파일을 보고 정한다. 배포 대상(Cloud Run 서비스 이름, 네임스페이스, 버킷 등)이 운영인지 스테이지인지 개발인지 확인한다.

gcloud builds triggers list --format="table(name,filename,github.push.tag,github.push.branch)"

현황 표의 9개 각각에 prod / stage / dev 중 하나를 확정한다. test 와 dev 를 굳이 나눌 필요가 없으면 둘 다 dev 로 묶는다. 표시는 세 가지만 쓴다.

끝난 걸 아는 법 · 트리거 9개(또는 그 이상) 전부에 세 값 중 하나가 붙었고, 애매한 게 하나도 안 남았으면 된다.

options:
  substitution_option: ALLOW_LOOSE

platform-dev-build 하나에만 변수를 넣고 빌드를 돌려 본다.

gcloud builds triggers export --trigger=platform-dev-build --destination=platform-dev-build.yaml

# 파일을 열어 아래 두 줄을 substitutions 아래에 추가한다
#   _ENV: dev
#   _SVC: 플랫폼

gcloud builds triggers import --source=platform-dev-build.yaml
gcloud builds triggers run platform-dev-build --branch=main

끝난 걸 아는 법 · 빌드가 성공하고(실패하면 위 ALLOW_LOOSE 를 안 넣은 것이다) 채널에 평소대로 알림이 온다. 이 시점에는 카드 모양이 아직 그대로여도 정상이다.

잘못되면 · 그 트리거의 빌드만 실패한다. 운영에는 영향이 없다. 되돌리는 법은 아래 5번에 있다.

2단계가 확인되면 나머지에도 넣는다. 저장소별로 cloudbuild.yaml 의 ALLOW_LOOSE 를 먼저 반영한 뒤에 트리거를 고친다.

_SVC 의 한글 이름은 예시다. 1단계에서 확인한 실제 서비스에 맞게 바꿔도 된다. 카드에 그대로 찍히는 값이라 개발을 모르는 사람이 읽을 이름으로 쓴다.

끝난 걸 아는 법 · 아래 명령으로 전부 값이 찍히는지 본다. 빈 것이 있으면 안 된다.

gcloud builds triggers list --format="table(name, substitutions._ENV, substitutions._SVC)"

운영 트리거는 태그를 밀어야 돌기 때문에 바로 확인이 어렵다. 값이 들어간 것만 위 명령으로 보고, 실제 카드는 다음 릴리즈 때 확인한다.

0단계에서 찾은 곳을 고친다. 새 카드 규격은 아래 새 카드 규격 에 필드 대응표와 JSON 예시로 적어 뒀다. 두 가지를 같이 한다.

1. 카드 제목 맨 앞에 환경 배지를 넣고, 부제에 소요 시간을 넣는다.
2. 성공 외에 FAILURE · TIMEOUT · INTERNAL_ERROR · CANCELLED 도 보내게 한다. QUEUED 와 WORKING 은 보내지 않는다.

끝난 걸 아는 법 · 실패 카드를 실제로 눈으로 본다. 빌드를 일부러 깨뜨릴 필요 없이 Pub/Sub 에 테스트 메시지를 하나 넣으면 된다.

gcloud pubsub topics publish cloud-builds \
  --attribute=buildId=test-0001,status=FAILURE \
  --message='{"id":"test-0001-aaaa-bbbb-cccc-000000000001","projectId":"aboutfishingproduct","status":"FAILURE","logUrl":"https://console.cloud.google.com/cloud-build/builds?project=aboutfishingproduct","startTime":"2026-09-10T02:50:00Z","finishTime":"2026-09-10T02:51:04Z","substitutions":{"TRIGGER_NAME":"booking-api-prod-build","REPO_NAME":"aboutfishing-booking-api","TAG_NAME":"v2.54.0","_ENV":"prod","_SVC":"예약 API"}}'

테스트 메시지를 보내면 실제 빌드가 도는 것이 아니라 알림만 한 건 간다. 채널에 test-0001 이 붙은 실패 카드가 뜨면 성공이다. 확인 후 그 메시지는 채널에서 지운다.

_ENV 가 비어 있으면 ⚠️ 환경 미지정 으로 표시하게 한다. 앞으로 누가 트리거를 새로 만들면서 변수를 빠뜨리면 이 표시로 바로 드러난다. 이게 없으면 몇 달 뒤에 조용히 틀린 채로 돌아간다.

끝난 걸 아는 법 · 위 테스트 메시지에서 _ENV 를 빼고 다시 보내 본다. 환경 미지정으로 떠야 한다.

지금 알림의 절반 이상이 dev·stage 다. 운영만 빌드봇 전체 에 남기고 나머지는 새 스페이스로 보낸다. 보내는 쪽에서 _ENV 값에 따라 웹훅 주소만 갈라 주면 된다.

새 스페이스와 웹훅 주소는 요청자가 만들어 전달한다. 만들지 여부는 8번을 보고 정한다.

릴리즈 한 번에 svc·map·booking 세 건이 따로 뜬다. 챗 웹훅 주소 뒤에 스레드 키를 붙이면 같은 태그끼리 한 스레드로 묶인다.

[웹훅 주소]&threadKey=[저장소]-[태그]&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD

끝난 걸 아는 법 · 다음 릴리즈에서 세 건이 한 스레드 안에 붙어서 온다.