[Docker]Docker Login 실패 원인 분석: GCP LB에서 HTTP 리다이렉트가 필요한 이유

Docker 프라이빗 레지스트리를 구축하고 GCP 로드 밸런서와 Nginx를 활용하여 서비스 하는 중 로그인이 안되는 현상이 발생했다.

 

1. 환경 구성

• GCP 로드 밸런서(L7)
• VM 인스턴스: Nginx와 Docker Registry가 Docker 컨테이너로 실행
• 트래픽 흐름:
  • 클라이언트는 https://도메인 로 접근
  • 로드 밸런서는 SSL 종료 후, 내부적으로 HTTP(포트 80)로 VM의 Nginx에 요청을 전달
  • Nginx는 해당 요청을 Docker Registry로 프록시
• Nginx 설정

    server {
      listen 80;
      server_name 도메인;

    location / {
        proxy_pass http://nexus:8081;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Cookie $http_cookie;
        }

    # /docker 경로 처리
    location /v2/ {
        proxy_pass http://nexus:5000;
        auth_basic off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Cookie $http_cookie;
        proxy_set_header Authorization $http_authorization;
        proxy_set_header X-Original-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Original-Proto $scheme;
        proxy_set_header Docker-Distribution-Api-Version registry/2.0;
     # 큰 이미지 파일 전송 처리
        client_max_body_size 0;  # 클라이언트 최대 파일 크기 제한 없앰
        }

    }

2. 문제 상황:

"docker login 도메인" 명령어 실행 시, 아래와 같은 에러가 발생 

Get "https://도메인/v2/": Get "http://도메인/v2/token?account=admin&client_id=docker&offline_token=true&service=http%3A%2F%2F도메인%2Fv2%2Ftoken": read tcp clientIp:56111->L7Ip:80: read: connection reset by peer



3. 원인 분석:

• Docker 인증 흐름:
  • Docker 클라이언트가 /v2/ 엔드포인트에 접근하면, 레지스트리는 401 Unauthorized 응답과 함께 WWW-Authenticate 헤더를 반환
  • 이 헤더에는 인증 토큰을 요청할 URL이 포함되어 있으며, 클라이언트는 해당 URL에 접근하여 토큰을 획득한 후 재요청을 수행

• 프로토콜 불일치:
  • WWW-Authenticate 헤더에서 제공하는 토큰 엔드포인트가 http://로 설정되어 있어, 클라이언트가 HTTP로 토큰을 요청
  • GCP 로드 밸런서 설정 시 http 포트 리다이렉트 설정을 하지 않아, http 요청을 처리하지 못하여 로그인 실패

4. 해결 방법:

• GCP 로드 밸런서 설정:
  • HTTP(포트 80)로 들어오는 모든 트래픽을 HTTPS(포트 443)로 리다이렉트하도록 설정

    

아마도 내가 nexus registry에 http 만 허용해서 리다이렉트 프로토콜이 http로 되어있지 않았나 싶다. 만약에 https 도 허용해주었다면 저 리다이렉트가 https로 오지 않았을까 하는 생각이 든다..그럼 문제도 없었겠지...이건 나중에 테스트를 다시 해봐야할 것 같다.