From 5429c754b85c37e8bc59b325dbcebd06b2f61786 Mon Sep 17 00:00:00 2001
From: rorrxr <rorrxr@naver.com>
Date: Mon, 20 Jul 2026 13:37:43 +0900
Subject: [PATCH] =?UTF-8?q?docs(ci)=20:=20=EB=B0=B0=ED=8F=AC=20=EC=9B=8C?=
 =?UTF-8?q?=ED=81=AC=ED=94=8C=EB=A1=9C=EC=97=90=20=ED=95=84=EC=9A=94/?=
 =?UTF-8?q?=ED=8F=90=EA=B8=B0=20Secrets=20=EB=B0=8F=20=EC=84=9C=EB=B2=84?=
 =?UTF-8?q?=20=EC=82=AC=EC=A0=84=20=EC=84=B8=ED=8C=85=20=EB=AC=B8=EC=84=9C?=
 =?UTF-8?q?=ED=99=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

GCP_SA_KEY 제거 이후 어떤 Secret이 실제로 쓰이는지 불명확해져
워크플로 상단에 주석으로 정리. 폐기된 Secret 목록과 서버 1회 세팅 절차 포함.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .github/workflows/deploy.yml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 8ba4966..b14481d 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -1,3 +1,21 @@
+# CI에서 빌드한 Docker 이미지를 GCE VM으로 직접 전송하여 배포한다.
+# (Artifact Registry를 경유하지 않으므로 GCP 서비스 계정 키가 필요 없다)
+#
+# 필요한 Secrets
+#   GCP_VM_IP        : GCE VM 외부 IP
+#   GCP_SSH_USER     : 배포 계정 (linkit_admin)
+#   GCP_SSH_PASSWORD : 배포 계정 비밀번호
+#   GCP_SSH_PORT     : SSH 포트 (22)
+#   그 외 애플리케이션 환경변수 (DB_*, REDIS_*, JWT_*, KAKAO_*, NAVER_*, NCP_* 등)
+#
+# 폐기된 Secrets (더 이상 참조하지 않음 — 삭제 가능)
+#   GCP_SA_KEY, GCP_SSH_KEY, GCP_PROJECT_ID, GCP_REGION, GCP_REPOSITORY
+#
+# 서버 사전 세팅 (1회, sudo 권한 계정으로 수행)
+#   sudo mkdir -p /opt/link-it
+#   sudo chown -R linkit_admin:linkit_admin /opt/link-it
+#   sudo usermod -aG docker linkit_admin
+#   sshd: PasswordAuthentication yes
 name: Deploy to GCP
 
 on: