Documentation survey

SUSE Manager 5.0 Proxy Deployment

This guide outlines the deployment process for the SUSE Manager 5.0 Proxy container on SLE Micro 5.5 or SUSE Linux Enterprise Server 15 SP6. This guide presumes you have already successfully deployed a SUSE Manager 5.0 Server.

SLE Micro는 당분간 일반 미니언(기본 연락 방법)으로만 지원됩니다. Salt SSH 클라이언트(salt-ssh 연락 방법)로도 관리할 수 있도록 개선하는 중입니다.

배포하려면 다음 작업을 수행합니다.

Procedure: Deploying Proxy

  1. 하드웨어 요구사항을 검토합니다.

  2. Synchronize the SLE Micro 5.5 or SUSE Linux Enterprise Server 15 SP6 parent channel and the proxy extension child channel on the server.

  3. Install SLE Micro or SUSE Linux Enterprise Server on a bare-metal machine.

  4. During the installation, register SLE Micro or SUSE Linux Enterprise Server along with the SUSE Manager Proxy extension.

  5. Salt 활성화 키를 생성합니다.

  6. 기본 연결 방법을 사용하여 프록시를 클라이언트로 부트스트랩합니다.

  7. 프록시 구성을 생성합니다.

  8. 프록시 구성을 서버에서 프록시로 전송합니다.

  9. 프록시 구성을 사용하여 클라이언트를 SUSE Manager의 프록시로 등록합니다.

프록시 컨테이너 호스트에 지원되는 운영 체제

The supported operating system for the container host are SLE Micro 5.5 and SUSE Linux Enterprise Server 15 SP6.

컨테이너 호스트

컨테이너 호스트는 컨테이너를 관리하고 배포할 수 있는 컨테이너 엔진(예: Podman)이 탑재된 서버입니다. 이러한 컨테이너는 필수적인 부분(예: 애플리케이션과 라이브러리)을 보관하지만, 전체 운영 체제는 보관하지 않으므로 경량화됩니다. 이 설정은 애플리케이션이 다양한 환경에서 동일한 방식으로 실행되도록 보장합니다. 컨테이너 호스트는 이러한 컨테이너에 필요한 리소스(예: CPU, 메모리, 스토리지)를 제공합니다.

1. 프록시의 하드웨어 요구사항

For more information about hardware requirements for deploying SUSE Manager Proxy, see installation-and-upgrade:hardware-requirements.adoc#proxy-hardware-requirements.

2. Synchronize the Parent and Proxy Extension Child Channels

This section presumes that you have already entered your organization credentials under the Admin  Setup Wizard  Organization Credentials in the server’s Web UI. Products are listed on the Admin  Setup Wizard  Products page. This channel must be fully synchronized on the server, with the child channel Proxy as an extension option selected.

Procedure: Synchronizing the Proxy Parent Channel and Proxy Extension

  1. SUSE Manager Web UI에서 관리  제품으로 이동합니다.

  2. From the products page enter SLE Micro or SUSE Linux Enterprise Server in the filter field.

  3. 다음으로 드롭다운을 사용하여 필요한 아키텍처를 선택합니다. 이 예제의 경우 x86-64입니다.

  4. In the Product Description field select the SLE Micro 5.5 or SUSE Linux Enterprise Server 15 SP6 checkbox then use the drop-down to select the SUSE Manager Proxy Extension 5.0 x86_64 extension.

  5. 제품 추가 버튼을 클릭합니다.

  6. 동기화가 완료될 때까지 기다립니다.

3. Prepare SUSE Manager Proxy Host

다음 하위 섹션에서는 SLE Micro 또는 SUSE Linux Enterprise Server를 사용하여 프록시 호스트를 준비합니다.

3.1. Prepare SLE Micro 5.5 Host

3.1.1. Download the installation media

Procedure: Downloading the Installation Media

  1. https://www.suse.com/download/sle-micro/에서 SLE Micro 5.5 설치 미디어를 찾습니다.

  2. SLE-Micro-5.5-DVD-x86_64-GM-Media1.iso를 다운로드합니다.

  3. 설치하기 위해 다운로드한 .iso 이미지가 들어 있는 DVD 또는 USB 플래시 드라이브를 준비합니다.

3.1.2. Install SLE Micro 5.5

시스템(가상 또는 물리) 준비에 대한 자세한 내용은 SLE Micro 5.5 배포 가이드를 참조하십시오.

Procedure: Installing SLE Micro 5.5

  1. SLE Micro 5.5의 설치 이미지가 들어 있는 DVD 또는 USB 플래시 드라이브(USB 디스크 또는 키)를 삽입합니다.

  2. 시스템을 부팅하거나 재부팅합니다.

  3. 화살표 키를 사용하여 설치를 선택합니다.

  4. Adjust Keyboard and language.

  5. 확인란을 클릭하여 라이선스 계약에 동의합니다.

  6. 다음을 클릭하여 계속합니다.

  7. Select the registration method. For this example, we will register the server with SUSE Customer Center.

    The SUSE Manager 5.0 containers are installed as extensions. Depending on the specific extension needed from the list below, additional SUSE Customer Center registration codes will be required for each.

    • SUSE Manager 5.0 서버

    • SUSE Manager 5.0 프록시

    • SUSE Manager 5.0 Retail Branch Server

    The SLE Micro 5.5 entitlement is included within the SUSE Manager entitlement, so it does not require a separate registration code.

  8. Enter your SUSE Customer Center email address.

  9. SLE Micro 5.5 등록 코드를 입력합니다.

  10. 다음을 클릭하여 계속합니다.

  11. To install a proxy, select the SUSE Manager 5.0 Proxy extension; to install a server, select the SUSE Manager 5.0 Server extension Checkbox.

  12. 다음을 클릭하여 계속합니다.

  13. Enter your SUSE Manager 5.0 extension registration code.

  14. 다음을 클릭하여 계속합니다.

  15. NTP 구성 페이지에서 다음을 클릭합니다.

  16. 시스템 인증 페이지에서 루트 사용자의 비밀번호를 입력합니다. 다음을 클릭합니다.

  17. 설치 설정 페이지에서 설치를 클릭합니다.

이를 통해 SLE Micro 5.5 및 SUSE Manager 5.0의 확장으로 설치가 완료됩니다.

3.1.3. OPTIONAL: Registration from the command line

If you added SUSE Manager 5.0 as an extension during SLE Micro 5.5 installation then you can skip this procedure. However, optionally you may skip registration during SLE Micro 5.5 installation by selecting the Skip Registration button. This section provides steps on registering your products after SLE Micro 5.5 installation.

The following steps register a SUSE Manager 5.0 extension with the x86-64 architecture and thus require a registration code for the x86-64 architecture. To register ARM or s390x architectures use the correct registration code.
Procedure: Registering from the Command Line

  1. List available extensions with the following command:

    transactional-update --quiet register --list-extensions

  2. From the list of available extensions, select the one you wish to install:

    1. If installing the Server, use your SUSE Manager Server Extension 5.0 x86_64 registration code with following command:

      transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r <reg_code>

    2. If installing the Proxy, use your SUSE Manager Proxy Extension 5.0 x86_64 registration code with following command:

      transactional-update register -p SUSE-Manager-Proxy/5.0/x86_64 -r <reg_code>

  3. 재부팅합니다.

3.1.4. 시스템 업데이트

Procedure: Updating the System

  1. root로 로그인합니다.

  2. transactional-update 실행:

    transactional-update

  3. 재부팅합니다.

SLE Micro는 기본적으로 자동으로 업데이트되도록 설계되어 있으며, 업데이트를 적용한 이후에는 재부팅됩니다. 그러나 SUSE Manager 환경에서 이는 올바른 동작이 아닙니다. SUSE Manager은(는) 서버에서 자동 업데이트를 방지하기 위해 부트스트랩 프로세스 중에 트랜잭션 업데이트 타이머를 비활성화합니다.

SLE Micro 기본 동작을 사용하려면 다음 명령을 실행하여 타이머를 활성화합니다.

systemctl enable --now transactional-update.timer

To continue with deployment, see 사용자 정의 영구 스토리지 구성.

3.2. Prepare SUSE Linux Enterprise Server 15 SP6 Host

Alternatively, you can deploy SUSE Manager on SUSE Linux Enterprise Server 15 SP6.

The following procedure describes the main steps of the installation process.

Procedure: Installing SUSE Manager Extensions on SUSE Linux Enterprise Server 15 SP6

  1. Locate and download SUSE Linux Enterprise Server 15 SP6 .iso at https://www.suse.com/download/sles/.

  2. 호스트 운영 체제(SUSE Linux Enterprise Server 15 SP6) 및 확장 프로그램 모두에 대해 등록 코드가 있어야 합니다.

  3. Start the installation of SUSE Linux Enterprise Server 15 SP6.

    1. On the Language, keyboard and product selection select the product to install.

    2. 라이선스 계약에서 계약서를 읽고 라이선스 약관에 동의합니다에 체크 표시합니다.

  4. Select the registration method. For this example, we will register the server with SUSE Customer Center.

  5. Enter your SUSE Customer Center email address.

  6. Enter your registration code for SUSE Linux Enterprise Server 15 SP6.

  7. 다음을 클릭하여 계속합니다.

    SUSE Linux Enterprise Server 15 SP6의 경우 유효한 SUSE Linux Enterprise Server 구독과 해당 등록 코드가 있어야 하며, 이 화면에서 해당 정보를 제공해야 합니다. 아래에 SUSE Manager 확장 프로그램 등록 코드를 입력해야 합니다.

  8. In the screen Extensions and Modules Selection check the following:

    • 서버를 설치하려면 SUSE Manager 서버 확장 프로그램을 선택하고, 프록시를 설치하려면 SUSE Manager 프록시 확장 프로그램을 선택합니다.

    • Basesystem Module

    • Containers Module

  9. 다음을 클릭하여 계속합니다.

  10. Enter your SUSE Manager 5.0 extension registration code.

  11. 다음을 클릭하여 계속합니다.

  12. 설치를 완료합니다.

  13. When the installation completes, log in to the newly installed server as root.

  14. 시스템 업데이트(선택 사항, 설치 중에 시스템이 업데이트를 다운로드하도록 설정되지 않은 경우):

    zypper up

  15. 재부팅합니다.

  16. 루트 권한으로 로그인하여 podman과 mgradm 및 mgradm-bash-completion 설치(아직 자동으로 설치되지 않은 경우):

    zypper install podman mgradm mgradm-bash-completion

  17. 시스템을 재부팅하거나 다음 명령을 실행하여 podman 서비스 시작:

    systemctl enable --now podman.service

To continue with deployment, see 사용자 정의 영구 스토리지 구성.

4. 사용자 정의 영구 스토리지 구성

Configuring persistent storage is optional, but it is the only way to avoid serious trouble with container full disk conditions. If custom persistent storage is required for your infrastructure, use the mgr-storage-proxy tool.

자세한 내용은 mgr-storage-proxy --help를 참조하십시오. 이 도구는 컨테이너 스토리지 및 Squid 캐시 볼륨 생성을 간소화합니다.

다음 방법으로 명령 사용:

mgr-storage-proxy <storage-disk-device>

예:

mgr-storage-proxy /dev/nvme1n1

이 명령은 /var/lib/containers/storage/volumes에 영구 스토리지 볼륨을 생성합니다.

For more information, see

5. 프록시용 활성화 키 생성

Procedure: Creating an Activation Key

  1. 시스템  활성화 키로 이동하여 키 생성을 클릭합니다.

  2. Create an activation key for the proxy host with SLE Micro 5.5 or SUSE Linux Enterprise Server 15 SP6 as the parent channel. This key should include all recommended channels and the proxy as an extension child channel.

  3. 프록시 호스트를 기본 클라이언트로 부스트래핑을 진행합니다.

6. 프록시 호스트를 클라이언트로 부트스트랩

Procedure: Bootstrapping the Proxy Host

  1. 시스템  부트스트랩을 선택합니다.

  2. 프록시 호스트의 필드를 입력합니다.

  3. 드롭다운에서 이전 단계에서 생성한 활성화 키를 선택합니다.

  4. 부트스트랩을 클릭합니다.

  5. 부트스트랩 프로세스가 완료될 때까지 기다립니다. Salt 메뉴를 선택한 후 Salt 키가 나열되고 수락되었는지 확인합니다.

  6. 운영 체제가 SLE Micro인 경우 프록시 호스트를 재부팅합니다.

  7. Select the host from the System list and trigger a second reboot in case of SLE Micro after all events are finished to conclude the onboarding.

Procedure: Updating the Proxy Host

  1. 시스템 목록에서 호스트를 선택하고 모든 패치를 적용하여 업데이트합니다.

  2. 운영 체제가 SLE Micro인 경우 프록시 호스트를 재부팅합니다.

7. 프록시 구성 생성

SUSE Manager 프록시의 구성 아카이브는 SUSE Manager 서버에서 생성됩니다. 각 추가 프록시에는 자체 구성 아카이브가 필요합니다.

2GB는 기본 프록시 squid 캐시 크기입니다. 사용자의 환경에 적합하도록 조정해야 합니다.

Podman 배포의 경우, 이 프록시 구성을 생성하기 전에 SUSE Manager 프록시의 컨테이너 호스트가 SUSE Manager 서버에 클라이언트로 등록되어 있어야 합니다.

프록시 FQDN을 사용하여 등록된 클라이언트가 아닌 프록시 컨테이너 구성을 생성하는 경우(Kubernetes 사용 사례와 같이), 시스템 목록에 새 시스템 항목이 표시됩니다. 이 새 항목은 이전에 입력한 프록시 FQDN 값 아래에 표시되며 시스템 유형은 외부입니다.

7.1. Web UI를 사용하여 프록시 구성 생성

절차: Web UI를 사용하여 프록시 컨테이너 구성 생성

  1. Web UI에서 Systems  프록시 구성으로 이동하여 필요한 데이터를 입력합니다.

  2. Proxy FQDN 필드에 프록시의 정규화된 도메인 이름을 입력합니다.

  3. 상위 FQDN 필드에 SUSE Manager Server 또는 다른 SUSE Manager Proxy에 대한 정규화된 도메인 이름을 입력하십시오.

  4. 프록시 SSH 포트 필드에 SSH 서비스가 SUSE Manager Proxy에서 수신 대기하는 SSH 포트를 입력하십시오. 권장 사항은 기본 포트인 8022를 유지하는 것입니다.

  5. In the Max Squid cache size [MB] field type maximal allowed size for Squid cache. Recommended is to use at most 80% of available storage for the containers.

    2GB는 기본 프록시 squid 캐시 크기입니다. 사용자의 환경에 적합하도록 조정해야 합니다.

SSL 인증서 선택 목록에서 SUSE Manager 프록시에 대해 새 서버 인증서를 생성해야 하는지 또는 기존 인증서를 사용해야 하는지 선택합니다. 생성된 인증서를 SUSE Manager 기본 제공(자체 서명) 인증서로 간주할 수 있습니다.

+ 선택에 따라 새 인증서를 생성하기 위해 CA 인증서에 서명할 경로 또는 프록시 인증서로 사용할 기존 인증서 및 해당 키에 대한 경로를 입력하십시오.

+ 서버에서 생성된 CA 인증서는 /var/lib/containers/storage/volumes/root/_data/ssl-build 디렉토리에 저장됩니다.

+ 기존 또는 사용자 정의 인증서와 기업 및 중간 인증서의 개념에 대한 자세한 내용은 SSL 인증서 임포트에서 확인할 수 있습니다.

  1. 생성을 클릭하여 SUSE Manager 서버에 새 프록시 FQDN을 등록하고 컨테이너 호스트에 대한 세부사항이 포함된 구성 아카이브(config.tar.gz)를 생성합니다.

  2. 잠시 후 다운로드할 파일이 표시됩니다. 이 파일을 로컬에 저장합니다.

suma proxy containerized webui

7.2. spacecmd 및 자체 서명 인증서를 사용하여 프록시 구성 생성

You can generate a Proxy configuration using spacecmd.

절차: spacecmd 및 자체 서명 인증서를 사용하여 프록시 구성 생성

  1. 컨테이너 호스트에 SSH로 연결합니다.

  2. 서버 및 프록시 FQDN을 바꾸는 다음 명령을 실행합니다.

    mgrctl exec -ti 'spacecmd proxy_container_config_generate_cert -- dev-pxy.example.com dev-srv.example.com 2048 email@example.com -o /tmp/config.tar.gz'

  3. 서버 컨테이너에서 생성된 구성을 복사합니다.

    mgrctl cp server:/tmp/config.tar.gz .

7.3. spacecmd 및 사용자 정의 인증서를 사용하여 프록시 구성 생성

You can generate a Proxy configuration using spacecmd for a custom certificates rather than the default self-signed certificates.

절차: spacecmd 및 사용자 정의 인증서를 사용하여 프록시 구성 생성

  1. 서버 컨테이너 호스트에 SSH로 연결합니다.

  2. 서버 및 프록시 FQDN을 바꾸는 다음 명령을 실행합니다.

    for f in ca.crt proxy.crt proxy.key; do
  mgrctl cp $f server:/tmp/$f
done
mgrctl exec -ti 'spacecmd proxy_container_config -- -p 8022 pxy.example.com srv.example.com 2048 email@example.com /tmp/ca.crt /tmp/proxy.crt /tmp/proxy.key -o /tmp/config.tar.gz'

  3. 서버 컨테이너에서 생성된 구성을 복사합니다.

    mgrctl cp server:/tmp/config.tar.gz .

8. 프록시 구성 전송

Web UI는 구성 아카이브를 생성합니다. 이 아카이브는 프록시 컨테이너 호스트에서 사용할 수 있도록 설정해야 합니다.

절차: 프록시 구성 복사

  1. 아직 완료하지 않은 경우 이전 단계에서 생성한 구성 아카이브(config.tar.gz)를 서버 컨테이너에서 서버 호스트로 복사합니다.

    mgrctl cp server:/root/config.tar.gz .

  2. If not already done, copy the files from the server host to the proxy host:

    scp config.tar.gz <proxy-FQDN>:/root

  3. On the proxy host, install the Proxy with:

    mgrpxy install podman config.tar.gz

9. Start the SUSE Manager Proxy

이제 mgrpxy 명령으로 컨테이너를 시작할 수 있습니다.

Procedure: Starting and Checking Proxy Status

  1. Start the proxy by calling:

    mgrpxy start

  2. 다음을 호출하여 컨테이너 상태 확인:

    mgrpxy status

    Five SUSE Manager Proxy containers should be present and should be part of the proxy-pod container pod:

    • proxy-salt-broker

    • proxy-httpd

    • proxy-tftpd

    • proxy-squid

    • proxy-ssh

10. Use a Custom Container Image for a Service

기본적으로 SUSE Manager 프록시 제품군은 각 서비스에 대해 동일한 이미지 버전과 레지스트리 경로를 사용하도록 구성됩니다. 그러나 -tag 및 -image로 끝나는 설치 파라미터를 사용하여 특정 서비스에 대한 기본값을 재정의할 수 있습니다.

예:

mgrpxy install podman --httpd-tag 0.1.0 --httpd-image registry.opensuse.org/uyuni/proxy-httpd /path/to/config.tar.gz

이는 다시 시작하기 전에 registry.opensuse.org/uyuni/proxy-httpds가 사용할 이미지이고 0.1.0이 버전 태그인 httpd 서비스의 구성 파일을 조정합니다.

값을 기본값으로 재설정하려면 해당 파라미터 없이 설치 명령을 다시 실행합니다.

mgrpxy install podman /path/to/config.tar.gz

이 명령은 먼저 모든 서비스의 구성을 전역 기본값으로 재설정한 다음 다시 로드합니다.