NGINX Management Suite – VM 혹은 Baremetal에 설치하기

해당 포스트에서는 NGINX Management Suite 및 필수 구성 요소를 설치하기 위한 가이드를 진행합니다.

NGINX Management Suite를 설치하려면 다음과 같은 준비물이 필요합니다.

  • NGINX Management Suite의 평가판 또는 유료 구독. NGINX Management Suite에 대해 NGINX STORE에 문의하세요.
  • NGINX Management Suite 플랫폼 및 모듈을 호스팅할 Linux 인스턴스
  • NGINX Plus 또는 NGINX OSS가 NGINX Management Suite를 호스팅하는 인스턴스에 설치되어 있어야 합니다.

외부 시스템의 액세스를 허용하기 위해 네트워크 방화벽을 열어야 합니다. NGINX Management Suite는 gRPC 및 API/web 인터페이스 모두에 대해 포트 443을 사용합니다.

목차

1. 설치 Workflow
2. 인증서 및 키 다운로드
3. NGINX 혹은 NGINX Plus 설치
4. ClickHouse 설치
 4-1. ClickHouse 기본 설정
5. NGINX Management Suite 레포지토리 추가
6. NGINX Management Suite 모듈 설치

1. 설치 Workflow

다음 다이어그램은 NGINX Management Suite를 설치하는데 필요한 단계를 보여줍니다. 이 페이지에서는 전제 조건을 설치하는 과정을 안내합니다.

NGINX Management Suite installation workflow

2. 인증서 및 키 다운로드

NGINX Management Suite의 인증서와 개인 키를 다운로드하려면 다음 단계를 따르세요. 이 파일들은 NGINX Management Suite를 설치하기 위한 공식 저장소를 추가할 때 필요합니다. 또한 NGINX Plus를 설치할 때도 인증서와 키를 사용할 수 있습니다.

1. NGINX Management Suite를 설치하는 호스트에서 /etc/ssl/nginx/ 디렉토리를 생성하세요.

sudo mkdir -p /etc/ssl/nginx

2. NGINX Management Suite의 .crt.key 파일을 MyF5에서 다운로드하거나 NGINX STORE에서 전달 받을 수 있습니다.

3. .crt 및 .key 파일을 이동하고 이름을 변경하세요.

sudo mv <nginx-mgmt-suite-trial.crt> /etc/ssl/nginx/nginx-repo.crt
sudo mv <nginx-mgmt-suite-trial.key> /etc/ssl/nginx/nginx-repo.key

Note:

다운로드한 파일 이름은 구독 유형에 따라 다를 수 있습니다. 실제 파일 이름과 일치하도록 위의 명령을 수정하세요.

3. NGINX 혹은 NGINX Plus 설치

NGINX Management Suite를 설치할 호스트에 NGINX 오픈소스 또는 NGINX Plus를 설치하세요. NGINX Management Suite는 NGINX를 프론트엔드 프록시로 사용하며 사용자 액세스를 관리하는 데에도 사용됩니다.

Note:

NGINX Plus를 설치하는 경우, 이전 섹션에서 추가한 nginx-repo.keynginx-repo.crt를 사용할 수 있습니다.

NGINX Management Suite는 다음과 같은 NGINX 버전을 지원합니다.

4. ClickHouse 설치

Note:

NGINX Management Suite는 ClickHouse 22.3.15.33 이상을 필요로 합니다.

NGINX Management Suite는 메트릭, 이벤트, 경고 및 구성 설정을 저장하기 위해 ClickHouse를 사용합니다.

Linux 배포판에 해당하는 탭을 선택한 다음, ClickHouse를 설치하기 위한 지침을 따르세요.

CentOS, RHEL, RPM 기반

CentOS, RHEL 및 RPM 기반 배포판에 ClickHouse를 설치하고 활성화하려면 다음 단계를 수행하세요.

1. 레포지토리를 설정합니다.

sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo

2. ClickHouse 서버 및 클라이언트를 설치합니다.

sudo yum install -y clickhouse-server clickhouse-client

중요!

ClickHouse를 설치할 때 비밀번호를 지정하거나 비밀번호를 비워둘 수 있는 옵션이 있습니다(기본값은 빈 문자열입니다). ClickHouse에 비밀번호를 지정하려는 경우, NGINX Management Suite를 설치한 후 /etc/nms/nms.conf 파일을 편집하여 ClickHouse 비밀번호를 입력해야 합니다.그렇지 않으면 NGINX Management Suite가 시작되지 않습니다. ClickHouse 설정을 사용자 정의하는 방법에 대한 자세한 내용은 ClickHouse 구성 주제를 참조하세요.

3. ClickHouse를 Enable하여 서버가 재시작되면 자동으로 시작되도록 설정하세요.

sudo systemctl enable clickhouse-server

4. ClickHouse server를 시작합니다.

sudo systemctl start clickhouse-server

5. ClickHouse가 실행 중인지 확인하세요.

sudo systemctl status clickhouse-server
Debian, Ubuntu, Deb 기반

Debian, Ubuntu 및 Deb 기반 배포판에 ClickHouse를 설치하고 활성화하려면 다음 단계를 수행하세요.

1. 레포지터리를 설정합니다.

sudo apt-get install -y apt-transport-https ca-certificates dirmngr
GNUPGHOME=$(mktemp -d)
sudo GNUPGHOME="$GNUPGHOME" gpg --no-default-keyring --keyring /usr/share/keyrings/clickhouse-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 8919F6BD2B48D754
sudo rm -r "$GNUPGHOME"
sudo chmod +r /usr/share/keyrings/clickhouse-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] https://packages.clickhouse.com/deb lts main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update

2. ClickHouse 서버 및 클라이언트를 설치합니다.

sudo apt-get install -y clickhouse-server clickhouse-client

중요!

ClickHouse를 설치할 때 비밀번호를 지정하거나 비밀번호를 비워둘 수 있는 옵션이 있습니다(기본값은 빈 문자열입니다). ClickHouse에 비밀번호를 지정하려는 경우, NGINX Management Suite를 설치한 후 /etc/nms/nms.conf 파일을 편집하여 ClickHouse 비밀번호를 입력해야 합니다. 그렇지 않으면 NGINX Management Suite가 시작되지 않습니다.

3. 서버 재시작 시 자동으로 시작되도록 ClickHouse를 활성화하세요.

sudo systemctl enable clickhouse-server

4. ClickHouse 서버를 시작합니다.

sudo systemctl start clickhouse-server

5. ClickHouse가 실행 중인지 확인하세요.

sudo systemctl status clickhouse-server

4-1. ClickHouse 기본 설정

NGINX Management Suite는 ClickHouse에 대해 다음과 같은 기본값을 사용합니다.

중요:

이러한 설정을 사용자 정의할 수 있습니다. 그러나 사용자 정의 설정을 사용하는 경우, NGINX Management Suite를 설치한 후 nms.conf 파일을 업데이트하기 위해 Configure ClickHouse 지침을 따르세요. 그렇지 않으면 NGINX Management Suite가 ClickHouse에 연결할 수 없습니다.
구성기본값Notes
clickhouse.addresstcp://localhost:9000
clickhouse.username
clickhouse.password
clickhouse.tls_modefalse
clickhouse.tls.addresstcp://localhost:9440
clickhouse.tls.skip_verifyfalseclickhouse.tls.skip_verify는 자체 서명된 인증서에만 사용되어야 하며, 제품 환경에서는 절대 권장되지 않습니다. true로 설정하면 인증서가 검증되지 않으므로 중간자 공격에 노출될 수 있습니다.
clickhouse.tls.key_path
clickhouse.tls.cert_path
clickhouse.tls.ca_path/etc/ssl/certs/ca-certificates.crtclickhouse.tls.ca_path의 기본값은 Ubuntu와 Debian에서는 기본적으로 작동합니다. 다른 배포판에서는 다른 인증 기관을 구성해야 합니다. 추가 정보는 해당 배포판의 문서를 참조하세요.

5. NGINX Management Suite 레포지토리 추가

NGINX Management Suite를 설치하려면 공식 저장소를 추가하여 미리 컴파일된 deb 및 rpm 패키지를 가져와야 합니다.

Linux 배포판에 해당하는 탭을 선택한 다음, NGINX Management Suite 레포지토리를 추가하기 위한 지침을 따르세요.

CentOS, RHEL, RPM 기반

NGINX Management Suite 리포지토리를 추가합니다.

  • CentOS/RHEL
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nms.repo
  • RHEL 8 : RHEL 8에서 설치하고 있는 경우 및 배포판의 NGINX를 사용하는 경우, 다음 명령을 실행하여 NGINX의 새 버전을 사용하세요.
sudo yum module disable nginx:1.14
sudo yum module enable nginx:1.20
  • Amazon Linux 2
sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nms-amazon2.repo
Debian, Ubuntu, DEB 기반

NGINX Management Suite 리포지토리를 추가합니다.

  • Debian
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/nms/debian `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nms.list
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/adm/debian `lsb_release -cs` nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nms.list
sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx
  • Ubuntu
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/nms/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nms.list
printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/adm/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nms.list
sudo wget -q -O /etc/apt/apt.conf.d/90pkgs-nginx https://cs.nginx.com/static/files/90pkgs-nginx

6. NGINX Management Suite 모듈 설치

NGINX Management Suite를 시작하시거나 사용 사례에 대해 상담 받아보시려면 NGINX STORE에 문의해보세요.

아래 뉴스레터를 구독하고 NGINX와 NGINX STORE의 최신 정보들을 빠르게 전달 받아보세요.

NGINX STORE를 통한 솔루션 도입 및 기술지원 무료 상담 신청

* indicates required