문서 본문으로 건너뛰기
솜사탕 Docs구성
가이드지원 중업데이트 2026-07-24기능 검증 2026-07-24

서비스 간 내부 연결

같은 프로젝트의 서버 서비스끼리 공개 인터넷을 거치지 않는 내부 주소로 연결합니다.

이 문서에서 다루는 내용

연결 만들기

  1. 1
    대상 API 서비스를 먼저 배포합니다
    같은 프로젝트에서 정상 실행 중인 HTTP 서비스를 연결 대상으로 선택할 수 있습니다.
  2. 2
    호출할 서비스의 연결 설정을 엽니다
    대상 서비스와 API처럼 알아보기 쉬운 고정 별칭을 선택해 저장합니다.
  3. 3
    호출할 서비스를 다시 배포합니다
    연결 정보는 다음 배포부터 적용됩니다. 저장만 하고 재배포하지 않으면 기존 실행 환경은 바뀌지 않습니다.
  4. 4
    서버 코드에서 관리 변수를 읽습니다
    별칭이 API라면 SOMSATANG_PRIVATE_API_URL을 사용합니다.

서버에서 호출하기

내부 주소는 브라우저 코드가 아니라 서버 런타임에서만 사용하세요. 서비스 이름을 바꾸거나 다시 배포해도 저장한 별칭과 환경변수 이름은 유지됩니다.

Node.js 서버 예시 · javascript
const apiBaseUrl = process.env.SOMSATANG_PRIVATE_API_URL;

if (!apiBaseUrl) {
  throw new Error("내부 API 연결이 설정되지 않았습니다.");
}

const response = await fetch(`${apiBaseUrl}/health`);

보안과 변경 사항

  • 같은 프로젝트의 production HTTP 서비스만 연결할 수 있습니다.
  • 내부 주소를 사용해도 로그인, API 토큰, 서비스 권한 검사는 계속 필요합니다.
  • 연결을 제거한 뒤 호출 서비스를 다시 배포하면 해당 관리 환경변수가 제거됩니다.
  • 기존 공개 도메인과 외부 HTTPS 동작은 그대로 유지됩니다.
  • 브라우저 번들, 저장소, 로그에 내부 주소를 직접 복사해 저장하지 마세요.