NGINX One 임시 설정 가져오기, 내보내기

많은 관리자 로컬 시스템, 가상 머신, Docker 컨테이너 등등에서 작업을 합니다. F5 NGINX One 콘솔은 설정의 가져오기와 내보내기를 지원합니다. 이 문서는 임시 설정 을 NGINX One 콘솔로 가져오거나, 내보내는 방법을 다룹니다.

NGINX의 설정 파일을 구성하는 데는 시간이 걸립니다. 이 경우 임시 설정이 도움이 될 수 있습니다. 임시 설정은 NGINX One 콘솔의 기능을 사용하는 초안처럼 동작합니다. 임시 설정은 유효하지 않은 설정이어도 괜찮습니다. NGINX 인스턴스로 설정을 push 하기 전에 작업을 저장할 수 있습니다.

임시 설정을 사용하면, NGINX One 콘솔의 다음 기능을 사용할 수 있습니다.

  • 자동 구문 검사
  • 문맥 문서
  • 진행 중인 작업의 동적 분석
  • F5 AI 어시스턴트의 설정 제안

작업을 마치고 변경 사항을 인스턴스나 구성 동기화 그룹으로 push 한 경우, 임시 설정은 삭제해도 좋습니다.

NGINX One 콘솔에 임시 설정을 추가하기 전에, NGINX One 콘솔 계정에 임시 설정 권한이 있는지 확인하세요.

여러 임시 설정을 API를 통해 가져오고, 내보내고, 관리할 수 있습니다.

목차

1. 고려 사항
2. NGINX One 임시 설정 가져오기
3. NGINX One 임시 설정 내보내기
4. 여러 임시 설정 관리하기

1. 고려 사항

NGINX One 콘솔은 tar.gz 형식의 ‘tarball‘ 압축 파일을 통해 임시 구성을 가져오고 내보냅니다. 이런 압축 파일을 다룰 때는 다음 사항을 유의하세요.

  • NGINX 설정 디렉터리에 바로 압축을 해제하지 마세요. 기존의 설정 파일을 덮어쓸 수 있습니다.
  • 파일은 기본 권한 설정인 0644로 설정됩니다.
  • 개인 정보나 비밀 정보가 담긴 파일을 포함하지 마십시오.
  • 숨겨진 파일은 무시됩니다: 압축 파일에 숨겨진 파일을 가져오거나 내보낼 경우, NGINX One 콘솔은 해당 파일을 포함하지 않습니다.
  • 압축 파일의 크기는 5MB로 제한됩니다. 압축되기 전의 파일의 크기의 합은 10MB로 제한됩니다.

팁:

파일의 압축을 해제하기 전에, tar -tvzf <archive-name>.tar.gz 명령어를 실행하세요. 이 명령어는 파일을 덮어쓰지 않고 압축 파일 내부의 파일과 디렉터리를 보여줍니다. tar -xvzf <archive-name>.tar.gz와 같은 명령어로 압축을 해제할 때 파일이 작성될 위치를 확인할 수 있습니다.

2. NGINX One 임시 설정 가져오기

임시 설정을 시스템에서 NGINX One 콘솔로 가져오기 위해 다음과 같이 준비해야 합니다.

  • tar.gz 형식으로 설정을 압축합니다. 예를 들어, 다음 명령어는 /etc/nginx 디렉터리의 파일을 for-import.tar.gz 이름으로 압축합니다.
$ tar czvf /etc/nginx for-import.tar.gz

압축 파일이 준비되었다면 NGINX One 콘솔로 임시 설정을 가져올 수 있습니다. 다음 단계를 따르세요.

  1. 좌측 메뉴에서 Staged Configurations를 선택합니다.
  2. Add Staged Configuration을 선택합니다.
  3. Import Configuration을 선택합니다.
  4. 가져올 임시 설정의 이름을 추가합니다.
  5. Import from File 선택합니다.
  6. 파일을 선택합니다. 이 과정은 운영 체제에 따라 다릅니다.
  7. 작업이 성공하면 성공 메시지를 확인할 수 있습니다.
    • 자주 발생하는 오류 중 하나는 파일 크기가 너무 커서 발생합니다.

3. NGINX One 임시 설정 내보내기

NGINX One에서 임시 설정을 다운받아 시스템으로 내보낼 수 있습니다. 다음 단계를 따르세요.

  1. 좌측 메뉴에서 Staged Configurations를 선택합니다.
  2. 내보낼 임시 설정을 선택합니다.
  3. 임시 설정 열의 우측에 있는 줄임표(…)를 선택합니다.
  4. Export를 선택합니다.
  5. 나타나는 파일 메뉴에서 압축 파일의 이름을 선택하고 결과를 저장합니다.
  6. 현재 NGINX 설정을 덮어쓰는 방식으로 파일의 압축을 해제하지 않도록 주의하세요.

4. 여러 임시 설정 관리하기

UI에서 여러 임시 설정을 삭제할 수 있습니다.

  1. 좌측 메뉴에서 Staged Configurations를 선택합니다.
  2. 삭제할 임시 설정을 선택합니다.
  3. Delete selected 버튼을 선택합니다.

API를 사용하면 더 많은 작업을 할 수 있습니다. 특히 각 설정의 object_id를 이용하면, Bulk Staged Configurations 엔드포인트를 통해 여러 임시 설정을 생성, 수정 또는 삭제할 수 있습니다.