솜사탕 Docs구성
서비스 간 내부 연결
같은 프로젝트의 서버 서비스끼리 공개 인터넷을 거치지 않는 내부 주소로 연결합니다.
연결 만들기
- 1대상 API 서비스를 먼저 배포합니다같은 프로젝트에서 정상 실행 중인 HTTP 서비스를 연결 대상으로 선택할 수 있습니다.
- 2호출할 서비스의 연결 설정을 엽니다대상 서비스와 API처럼 알아보기 쉬운 고정 별칭을 선택해 저장합니다.
- 3호출할 서비스를 다시 배포합니다연결 정보는 다음 배포부터 적용됩니다. 저장만 하고 재배포하지 않으면 기존 실행 환경은 바뀌지 않습니다.
- 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 동작은 그대로 유지됩니다.
- 브라우저 번들, 저장소, 로그에 내부 주소를 직접 복사해 저장하지 마세요.