인증서 갱신 방식
clmBot은 두 가지 인증서 갱신 방식을 지원하므로, 서버 네트워크 환경에 따라 각각 선택할 수 있습니다:
| 업데이트 방식 | 작동 모드 | 포트 요구 사항 | 적용 시나리오 |
|---|---|---|---|
| 클라우드 푸시 | 관리 백엔드에서 푸시를 시작하고, clmBot 서버가 수신하여 업데이트 | 8862/tcp 인바운드 포트 개방 필요 | 네트워크 정책이 허용하고, 업데이트가 즉시 적용되기를 원하는 경우 |
| 예약 풀링 | crontab 또는 Windows 예약 작업으로 clmBot을 정기적으로 실행하여 업데이트 확인 | 인바운드 포트 개방 불필요 | 인바운드 포트를 개방할 수 없는 서버(기본 방식 권장) |
두 가지 방식은 서로 충돌하지 않으며, 동일한 서버 그룹에서 일부는 푸시를 사용하고 일부는 정기 풀링을 사용할 수 있습니다.
방법 1: 클라우드 푸시
서버에서 clmBot 서버 시작
./clm-bot-linux-amd64 server -a="0.0.0.0:8862"
-a 수신 주소와 포트를 지정하며, 기본값은 0.0.0.0:8862입니다.시작 후 clmBot은 서버 측에서 상시 실행되어 클라우드의 푸시를 기다립니다.
- 서버 방화벽과 클라우드 보안 그룹에서
8862/tcp인바운드 포트를 개방해야 합니다. - clmBot 서버는 클라우드 푸시 연결에 대해 상호 TLS 인증을 활성화하며, 접속 활성화가 완료된 노드의 푸시 인증서만 허용합니다.
인바운드 포트를 개방하지 않으려면 방법 2: 정기적 가져오기를 사용하세요.
clmBot 서버는 푸시를 수신하려면 계속 실행 중이어야 합니다. 프로덕션 환경에서는 시스템 서비스로 등록하고 부팅 시 자동 시작하도록 설정하는 것이 좋습니다. 서비스화 배포 및 업그레이드를 참조하세요.
관리 콘솔에서 인증서 푸시
관리 백엔드에 로그인하여 설치 지점 목록으로 이동한 후, 대상 설치 지점을 찾아 인증서 푸시를 클릭합니다. 확인하면 시스템이 최신 인증서를 서버로 푸시하고 자동으로 업데이트를 완료합니다.
방법 2: 정기적 가져오기
定时 가져오기 모드는 인바운드 포트를 개방할 필요가 없으며 권장되는 기본 방식입니다.clmBot에는 주기 스케줄러가 포함되어 있지 않으므로 crontab, Windows 예약 작업 또는 기존 스케줄링 시스템을 통해 업데이트 명령을 정기적으로 실행해야 합니다.
Linux: crontab 구성
crontab에 clmBot 업데이트 명령 추가:
crontab -e
매일 오전 3시에 인증서 갱신 확인을 실행하는 행을 추가합니다:
0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
- 명령에서 먼저
cdclmBot 설치 디렉터리로 이동한 후 실행해야 합니다. clmBot은 기본적으로 현재 디렉터리에서config.yaml을(를) 읽기 때문입니다. - 디렉터리를 변경하지 않고
-c매개변수로 구성 파일 경로를 지정할 수도 있습니다:./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate. - 경로는 실제 설치 디렉터리로 바꾸십시오.
실행 출력은 update.log에 추가되며, 동시에 clmBot은 설정 파일이 위치한 디렉터리의 logs/clm-bot.log에 실행 로그를 기록합니다.
Windows: 예약된 작업 구성
Windows 서버에서 예약된 작업을 생성하여 정기적으로 실행합니다:
cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1
생성 완료 후 작업을 마우스 오른쪽 버튼으로 클릭하여 실행을 선택해 검증한 다음, 설치 디렉터리에서 로그를 확인하여 실행 결과를 확인할 수 있습니다.
인증서 자동 재서명 및 갱신
clmBot이 업데이트하는 인증서는 클라우드의 자동 재발급에서 제공됩니다.관리 백엔드에 로그인하여 SSL 인증서 상세 페이지로 이동한 후, 자동 재발급 설정에서 재발급 주기(예: 30일)를 선택하거나 입력하고 저장합니다.
설정 후 전체 효과:
- 인증서 만료 전, 클라우드가 재발급 주기에 따라 자동으로 재발급을 완료하여 새 인증서를 생성합니다.
- clmBot이 설정된 방식(푸시 또는 정기 풀링)으로 새 인증서를 획득합니다.
- clmBot이 로컬 인증서에 대해 업데이트를 수행합니다:
- 로컬 인증서가 클라우드의 최신 인증서와 일치하면 업데이트를 건너뜁니다.
- 일치하지 않으면 타임스탬프가 포함된
.bak백업 생성을 시도하고,before_script실행, 새 인증서 기록,after_script실행을 순서대로 수행합니다. 백업에 실패하면 오류를 기록하되 업데이트는 계속합니다. 서비스 재로드 완료 여부는 스크립트 결과와 미들웨어 상태를 기준으로 합니다.
인증서를 갱신하지 않고 after_script를 한 번 강제 실행하려면(예: 스크립트 재로드 디버깅) --force-after 매개변수를 사용할 수 있습니다.