CB‐Spider Server Configuration(KR) - cloud-barista/cb-spider GitHub Wiki

CB-Spider 서버 설정

Language: English | 한국어

CB-Spider 서버 설정 방법

• CB-Spider 서버의 접근 방식 및 비밀번호 등을 설정합니다.
• 보통 비밀번호(SPIDER_PASSWORD)만 설정하면 로컬 운영 가능합니다.

  • 설정 정보

    환경 변수 설명 기본값
    CBSPIDER_ROOT 설치된 CB-Spider 패키지의 루트 경로 설정 setup.env 파일 위치로 자동 설정
    SERVER_ADDRESS 서버 가동 주소 및 포트 설정. 참고) CB-Spider Service Address Configuration 미설정(localhost 사용, 외부 접근 불가)
    SERVICE_ADDRESS 서비스 접근 주소 및 포트 설정(2중 네트워크 환경 등 필요시만 설정). 참고) CB-Spider Service Address Configuration 미설정(localhost 사용, 외부 접근 불가)
    PLUGIN_SW 클라우드 인프라 드라이버를 동적으로 추가 및 연결하는 옵션. ON으로 설정하면 공유 라이브러리로 빌드된 드라이버를 동적으로 등록하고 관리합니다. PLUGIN_SW=OFF
    ID_TRANSFORM_MODE 리소스 생성 시 ID 변환 수행 여부를 설정하는 옵션. OFF로 설정하면 사용자가 입력한 ID를 UUID 형식으로 변환하지 않고 CSP에 요청합니다(OFF로 설정 시 사용자는 CSP별 명명 제약사항을 고려해야 합니다). 참고) ID Transform ON/OFF Guide ID_TRANSFORM_MODE=ON
    CBLOG_ROOT 로그 출력을 위한 cb-log의 루트 경로 설정; cb-log가 설정 파일 등을 찾는 데 사용됩니다. CBSTORE_ROOT=$CBSPIDER_ROOT
    ADMINWEB AdminWeb UI 및 Swagger UI 활성화/비활성화 옵션. OFF로 설정하면 AdminWeb과 Swagger UI가 모두 비활성화됩니다. 참고) [AdminWeb ON/OFF Guide] ADMINWEB=ON
    MC_INSIGHT_API_TOKEN 멀티클라우드 메타데이터 검색을 위한 MC-Insight API 토큰 설정. MC-Insight 서비스 관리자로부터 토큰을 발급받아 설정합니다. 비어있으면 MC-Insight 기능이 비활성화됩니다. MC_INSIGHT_API_TOKEN=c72df1af9b1f0c29
    SPIDER_USERNAME / SPIDER_PASSWORD REST API 인증(Basic Auth)을 위한 ID/PW 설정. ⚠️ 중요: 두 값 모두 반드시 설정해야 합니다. 둘 중 하나라도 비어있으면 서버가 시작되지 않습니다. 참고) 인증 가이드 SPIDER_USERNAME=admin SPIDER_PASSWORD=

  • 설정 파일: ./setup.env

     #!/bin/bash

 # root path of cb-spider
 SCRIPT_DIR=`dirname ${BASH_SOURCE[0]-$0}`
 export CBSPIDER_ROOT=`cd $SCRIPT_DIR && pwd`

 ### Set Spider server Address of Service Address
 # cf) https://github.com/cloud-barista/cb-spider/wiki/CB-Spider-Service-Address-Configuration
 # default: unset SERVER_ADDRESS and unset SERVICE_ADDRESS
 # examples for other service port
 #export SERVER_ADDRESS=":3000"

 # examples for K8S env
 #export SERVER_ADDRESS=":1024"
 #export SERVICE_ADDRESS="1.2.3.4:31024"

 ### Set the library type of Cloud Driver pkg.
 # ON is a shared library type.
 # default: OFF (will be deprecated)
 export PLUGIN_SW=OFF

 ## If the value is OFF, Spider does not perform ID transformation.
 # default: ON
 export ID_TRANSFORM_MODE=ON

 # root path of cb-log
 export CBLOG_ROOT=$CBSPIDER_ROOT

 # AdminWeb ON/OFF setting
 # ON: Enable AdminWeb, OFF: Disable AdminWeb
 # default: ON
 export ADMINWEB=ON

 # MC-Insight API Token for multi-cloud metadata search
 # Get token from MC-Insight service administrator
 # If empty, MC-Insight features will be disabled
 export MC_INSIGHT_API_TOKEN=c72df1af9b1f0c29

 # REST API Authentication (Basic Auth) - REQUIRED
 # - Both SPIDER_USERNAME and SPIDER_PASSWORD must be set. Server will not start without them.
 export SPIDER_USERNAME=admin
 export SPIDER_PASSWORD=

⚠️ 인증 필수: 서버를 시작하려면 SPIDER_USERNAME과 SPIDER_PASSWORD를 모두 설정해야 합니다.
둘 중 하나라도 누락되면 서버가 log.Fatal로 종료됩니다.
CLI(spctl)의 경우 환경변수 또는 -u/-p 플래그를 통해 인증 정보를 제공할 수 있습니다.
자세한 내용은 인증 가이드 및 CLI Install Guide를 참조하세요.

  • setup.env 파일을 수정한 경우, 변경사항을 적용하려면 서버를 재시작해야 합니다.