From c90253efd6bb9379a1b60633c1850ece2b477446 Mon Sep 17 00:00:00 2001
From: hiondal <hiondal@gmail.com>
Date: Fri, 12 Sep 2025 19:34:41 +0900
Subject: [PATCH] =?UTF-8?q?Jenkins=20=EA=B0=80=EC=9D=B4=EB=93=9C=20Docker?=
 =?UTF-8?q?=20Hub=20=EC=9E=90=EA=B2=A9=EC=A6=9D=EB=AA=85=20=EC=84=A4?=
 =?UTF-8?q?=EC=A0=95=20=EB=B3=B4=EA=B0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Docker Hub Credentials 필수 설정 명확화
- Rate Limit 해결을 위한 자격증명 등록 방법 강조
- Jenkins 관리자 수행 작업 구체화

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 deployment/cicd/jenkins-pipeline-guide.md | 43 ++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/deployment/cicd/jenkins-pipeline-guide.md b/deployment/cicd/jenkins-pipeline-guide.md
index 909ca41..f78669f 100644
--- a/deployment/cicd/jenkins-pipeline-guide.md
+++ b/deployment/cicd/jenkins-pipeline-guide.md
@@ -43,14 +43,19 @@ Manage Jenkins > Credentials > Add Credentials
 - Password: {ACR_PASSWORD}
 ```
 
-#### 3. Docker Hub Credentials (Rate Limit 해결용)
+#### 3. Docker Hub Credentials (Rate Limit 해결용) ⚠️ **필수**
 ```
+Manage Jenkins > Credentials > Add Credentials
 - Kind: Username with password
 - ID: dockerhub-credentials
 - Username: {DOCKERHUB_USERNAME}
 - Password: {DOCKERHUB_PASSWORD}
 ```
 
+**⚠️ 중요**: Docker Hub 계정이 없으면 다음 중 하나 선택:
+1. Docker Hub 무료 계정 생성 (https://hub.docker.com)
+2. 또는 Jenkinsfile에서 Docker Hub 로그인 제거 (아래 참조)
+
 #### 4. SonarQube Token
 ```
 - Kind: Secret text
@@ -361,6 +366,42 @@ sh "echo \${environment}"
 sh "echo ${environment}"
 ```
 
+### **Docker Hub 계정이 없는 경우 대안**
+
+Docker Hub 계정 생성이 어려운 경우, 다음과 같이 Jenkinsfile을 수정할 수 있습니다:
+
+```groovy
+// 수정 전 (Docker Hub 로그인 포함)
+withCredentials([
+    usernamePassword(
+        credentialsId: 'acr-credentials',
+        usernameVariable: 'ACR_USERNAME',
+        passwordVariable: 'ACR_PASSWORD'
+    ),
+    usernamePassword(
+        credentialsId: 'dockerhub-credentials',
+        usernameVariable: 'DOCKERHUB_USERNAME', 
+        passwordVariable: 'DOCKERHUB_PASSWORD'
+    )
+]) {
+    sh "podman login docker.io --username \$DOCKERHUB_USERNAME --password \$DOCKERHUB_PASSWORD"
+    sh "podman login acrdigitalgarage01.azurecr.io --username \$ACR_USERNAME --password \$ACR_PASSWORD"
+    // ...
+}
+
+// 수정 후 (Docker Hub 로그인 제거)
+withCredentials([usernamePassword(
+    credentialsId: 'acr-credentials',
+    usernameVariable: 'ACR_USERNAME',
+    passwordVariable: 'ACR_PASSWORD'
+)]) {
+    sh "podman login acrdigitalgarage01.azurecr.io --username \$ACR_USERNAME --password \$ACR_PASSWORD"
+    // ...
+}
+```
+
+**⚠️ 주의**: Docker Hub 로그인을 제거하면 pull rate limit에 걸릴 수 있습니다.
+
 ### **배포 전 최종 검증 스크립트**
 ```bash
 #!/bin/bash