여러 Profile 사용¶
Profile은 별칭이 있는 완전한 OWL 구성으로, Endpoint, API Key 및 선택적 워크스페이스 정보를 포함합니다. 여러 계정, 사이트 또는 환경을 격리해 저장할 수 있습니다.
추가 및 전환¶
owl profile add customer-a
owl profile add customer-b --from ./customer-b.yaml
owl profile list
owl switch customer-a
owl profile current
profile add는 구성만 저장하며 자동으로 선택하지 않습니다. 추가와 전환은 로컬 검증만 수행하고, 인증은 실제 요청 시 확인됩니다. 오류 발생 시 다른 Profile로 자동 전환하지 않습니다.
owl --profile customer-b sync
owl --profile customer-b exec owl.data.show_dql_namespace
OWL_PROFILE=customer-b owl profile current -f json
선택 우선순위는 --profile > OWL_PROFILE > owl switch로 저장한 기본값입니다. --profile은 도구 이름 앞에 지정하세요.
파일과 캐시 격리¶
이름이 있는 Profile은 ${OWL_DIR}/profiles/ 아래에 별도의 구성, 자격 증명, 캐시, 데이터, 로그 디렉터리를 사용합니다. 도구 캐시는 Endpoint와 Key별로도 분리됩니다.
기존 ${OWL_DIR}/config.yaml은 예약된 default Profile로 유지됩니다. Profile이 선택되면 Endpoint와 Key는 해당 Profile에서 함께 가져오며 OWL_REGISTRY_ENDPOINT, OWL_API_KEY, OWL_TOKEN이 덮어쓰지 않습니다.
CLI의 --conf는 사용 중단 예정이며 도움말에서 숨겨졌습니다. 마이그레이션 기간에는 호환되지만 --profile과 함께 사용할 수 없습니다. Registry 서비스의 --config는 영향을 받지 않습니다.
쉘 자동 완성¶
자동 완성은 Profile 별칭, 카테고리, 도구 이름, 매개변수, schema enum 값을 제안합니다. 선택한 Profile의 로컬 캐시만 읽으며 네트워크 접속이나 도구 실행은 하지 않습니다.
이름 변경 및 삭제¶
owl profile rename customer-a customer-a-prod
owl profile remove customer-b
owl profile remove obsolete-profile --purge
일반 삭제는 cache/data를 보존합니다. --purge는 관리되는 산출물도 삭제합니다. purge가 실패하면 구성, 자격 증명, 별칭이 유지되거나 복구되어 권한을 수정한 후 다시 시도할 수 있습니다. default는 이름을 바꾸거나 삭제할 수 없습니다.