Foundry CLI 설치와 인증

Foundry CLI의 실행 이름은 foundry입니다. macOS, Windows와 Linux에서 SuperRepo 생성, 빌드, 미리보기와 배포를 수행합니다. 저장소를 Foundry 안이나 외부에 두어도 사용할 수 있습니다.

설치 경로

권장 경로는 플랫폼 인스턴스 루트 주소에 /workspace/code/superrepo를 붙여 여는 대화형 설치입니다. 이 방식은 일반 사용자 생성 토큰보다 제한된 설치용 토큰을 제공합니다.

CLI는 자신의 플랫폼 인스턴스에서 내려받습니다. 패키지 매니저나 별도의 독립 배포 파일에서 설치하는 방식은 아닙니다.

수동 설치의 환경 값

FOUNDRY_URL은 실제 플랫폼 인스턴스의 루트 HTTPS 주소, TOKEN은 설치 요청에 사용할 토큰입니다. 두 값은 설치 프로그램 다운로드에만 사용하며 설치된 CLI의 지속적인 인증은 별도의 foundry login으로 구성합니다.

사용자 생성 토큰에는 별도 scope 선택이 없으므로 설치에 특정 scope를 지정하지 않습니다. 그 토큰이 가진 사용자 권한 범위는 그대로 적용되므로 더 제한된 플랫폼 내 설치를 우선합니다.

macOS와 Linux

같은 Bash 세션의 환경에 FOUNDRY_URL과 TOKEN을 제공한 뒤 설치 스크립트를 내려받습니다.

: "${FOUNDRY_URL:?플랫폼 인스턴스의 루트 HTTPS URL이 필요합니다}"
: "${TOKEN:?설치 프로그램을 읽을 토큰이 필요합니다}"
export FOUNDRY_URL TOKEN
curl --fail --silent --show-error \
    "$FOUNDRY_URL/code/api/extension/install-script" \
    --header "Authorization: Bearer $TOKEN" \
    --output install-foundry.sh

다운로드가 성공했는지 확인하고 자신의 플랫폼 주소에서 받은 스크립트를 검토한 뒤 실행합니다.

bash install-foundry.sh

Windows PowerShell

같은 PowerShell 세션에 FOUNDRY_URL과 TOKEN을 제공한 뒤 실행합니다. 다운로드 실패 시 기존 파일을 실행하지 않도록 오류에서 중단합니다.

$ErrorActionPreference = "Stop"
if (-not $env:FOUNDRY_URL) { throw "FOUNDRY_URL이 필요합니다." }
if (-not $env:TOKEN) { throw "설치용 TOKEN이 필요합니다." }
Invoke-WebRequest -Uri "$env:FOUNDRY_URL/code/api/extension/install-bat" `
    -Headers @{ Authorization = "Bearer $env:TOKEN" } -OutFile "install-foundry.bat"

파일 내용을 확인한 뒤 실행합니다.

.\install-foundry.bat

CLI에 로그인

foundry login

대화형 입력에서 Foundry URL과 토큰을 제공합니다. CLI는 이 인증을 저장하여 이후 명령, 로컬 개발 서버 및 deploy에 사용합니다.

CI에서는 FOUNDRY_TOKEN을 외부 비밀정보로 주입하고 --foundry-url을 전달합니다.

: "${FOUNDRY_URL:?Foundry 루트 URL이 필요합니다}"
: "${FOUNDRY_TOKEN:?CLI 로그인 토큰이 필요합니다}"
export FOUNDRY_TOKEN
foundry login --foundry-url "$FOUNDRY_URL"

설치용 TOKEN과 로그인용 FOUNDRY_TOKEN은 이름과 사용 목적이 다릅니다. 로그인 뒤 설치용 토큰이 만료되거나 제거되어도 이미 설치한 CLI에는 영향을 주지 않습니다. 필요가 끝난 설치용 비밀값은 실행 환경에서 제거하고 토큰 수명 정책에 따라 폐기합니다.

만료, 갱신과 도움말

이후 명령에서 인증 오류가 나면 저장한 로그인 토큰의 만료 여부를 확인하고 브라우저에서 다시 승인합니다.

foundry login refresh

CLI 자체를 최신으로 갱신할 수 있습니다.

foundry update self

명령과 옵션은 다음 도움말에서 확인합니다.

foundry --help

저장소 생성, 배포 및 여러 제품 구성은 같은 CLI를 사용합니다.

Keyboard shortcuts