본문으로 건너뛰기

빠른 시작

본 페이지는 15분 내에 clmBot 배포를 완료하고 전체 인증서 갱신 프로세스를 한 번 실행하는 방법을 안내합니다.

시작하기 전에 다음을 확인하세요:

  • sslTrus CaaS 서비스를 이미 개통하였고, 관리 콘솔에 로그인할 수 있습니다.
  • 대상 서버에서 클라우드 서비스로 아웃바운드 접근이 가능합니다.
  • 서버의 관리자 권한을 보유하고 있습니다(clmBot 설치 및 초기화에 사용).

1단계: AccessKey / AccessSecret 생성​

관리 백엔드에 로그인하여 sslTrus CaaS 서비스 -> 제품 상세 -> SSL 인증서 상세로 이동한 후, 生成AK/SK을(를) 클릭하여 AccessKey(AK)와 AccessSecret(SK)을 받습니다.

주의

AccessKey와 AccessSecret을 안전하게 보관하세요. AccessSecret을 Git 저장소에 커밋하거나, 공개 스크립트에 기록하거나, 신뢰할 수 없는 타사 시스템으로 전송하지 마세요. 유출이 의심되면 관리 콘솔에서 다시 생성하세요.

2단계: clmBot을 다운로드하여 서버에 업로드​

clmBot 릴리스 페이지에서 해당 시스템 버전의 프로그램을 다운로드하세요:

clmBot 다운로드

서버의 운영 체제와 아키텍처에 맞는 버전(예: clm-bot-linux-amd64)을 선택하여 서버에 업로드합니다.독립 설치 디렉터리를 생성하는 것을 권장합니다(예: /opt/clm-bot).

mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64

3단계: 로그인 연동​

설치 디렉터리에서 login 명령을 실행하여 연결을 완료합니다:

./clm-bot-linux-amd64 login

안내에 따라 먼저 클라우드 주소 번호를 선택하거나(또는 클라우드 주소를 직접 입력)한 후, AccessKey와 AccessSecret를 순서대로 입력합니다.

로그인에 성공하면 clmBot이 설치 디렉터리에 config.yaml 설정 파일을 생성하여 연결 정보를 저장합니다.

4단계: 관리 콘솔에서 노드 활성화​

관리 백엔드에 로그인하여 clmBot 노드 목록으로 이동하면 새 clmBot 노드가 추가된 것을 확인할 수 있습니다.노드 오른쪽의 접속 허용 여부 스위치를 클릭하여 해당 노드를 활성화합니다.

정보

새로 연결된 노드는 기본적으로 비활성화 상태이며, 백엔드에서 활성화한 후에만 clmBot이 클라우드에서 인증서를 정상적으로 가져올 수 있습니다.

5단계: 서버에서 인증서 검색​

인증서 검색 명령을 실행하여 서버에 배포된 인증서와 저장 경로를 자동으로 스캔합니다:

./clm-bot-linux-amd64 discover-certificate

명령 실행 후 찾은 인증서 정보(출처, 유형, 발급자, 경로, 도메인 등)가 표 형식으로 나열됩니다.업로드할 인증서 일련번호를 입력하여 백엔드 관리에 추가되었는지 확인하세요:

  • all: 모두 업로드
  • none: 업로드하지 않음
  • 1,3-5: 일련번호로 선택, 범위 표기 지원

업로드가 성공하면 해당 인증서는 설치 지점으로 관리자 콘솔에 표시되며, clmBot은 현재 디렉터리의 config.yaml에 각 설치 지점에 해당하는 설정을 생성합니다.

정보

자동 생성된 구성에서 각 설치 지점에는 before_script, after_script 필드가 포함되며, 여기서 after_script는 인증서 갱신 후 실행되는 재로드 스크립트로 실제 환경에 따라 사용 가능 여부를 확인해야 합니다. 필드 의미는 구성 참조를 참조하세요.

6단계: 첫 번째 인증서 갱신 완료​

관리 콘솔에서 인증서 자동 재서명 주기를 설정한 후( 인증서 갱신 방식 참조), 전체 프로세스를 검증하기 위해 수동으로 한 번 갱신을 트리거할 수 있습니다:

./clm-bot-linux-amd64 update-certificate

실행 후 clmBot이 클라우드에 더 새로운 인증서가 있는지 확인합니다:

  • 로컬 인증서가 이미 최신 상태: 안내 메시지를 출력하고 건너뜁니다.
  • 클라우드에 새 인증서가 있음: .bak 백업 생성을 시도하고, 새 인증서를 기록하며, 설정에 따라 after_script를 실행합니다. 백업 실패 시 오류를 기록하지만 업데이트는 계속 진행됩니다. 서비스 재로드 완료 여부는 스크립트 결과와 미들웨어 상태를 기준으로 합니다.

다음 단계​

최종 수정: 에