4.3. Red Hat Edge Manager의 bootc 운영 체제 이미지 빌드

프로세스

1. 다음 명령을 실행하여 시스템에 적합한 리포지토리의 서브스크립션 관리자를 활성화합니다.

   sudo subscription-manager repos --enable ansible-automation-platform-2.5-for-rhel-9-x86_64-rpms

   Copy to Clipboard Toggle word wrap

   Red Hat Edge Manager에서 사용 가능한 리포지토리의 전체 목록은 추가 리소스 섹션을 참조하십시오.

2. 다음 명령을 실행하여 패키지 관리자와 함께plane ctl CLI를 설치합니다.

   sudo dnf install flightctl

   Copy to Clipboard Toggle word wrap

프로세스

1. CLI를 통해 Red Hat Edge Manager에 로그인할 단계를 수행하여lightctl CLI에 로그인합니다.

   참고

   CLI는 호스트의 인증 기관 풀을 사용하여 Red Hat Edge Manager 서비스의 ID를 확인합니다. 확인으로 인해 자체 서명된 인증서를 사용할 때 인증 기관 인증서를 풀에 추가하지 않는 경우 TLS 확인 오류가 발생할 수 있습니다. 명령에 --insecure-skip-tls-verify 플래그를 추가하여 서버 확인을 바이패스할 수 있습니다.

2. 다음 명령을 실행하여 에이전트 구성 파일의 형식으로 등록 자격 증명을 가져옵니다.

   flightctl certificate request --signer=enrollment --expiration=365d --output=embedded > config.yaml

   Copy to Clipboard Toggle word wrap
   참고
   • --expiration=365d 옵션은 인증 정보가 1년 동안 유효함을 지정합니다.
   • --output=embedded 옵션은 출력이 등록 자격 증명이 포함된 에이전트 구성 파일임을 지정합니다.

   반환된 config.yaml 에는 Red Hat Edge Manager 서비스의 URL, 인증 기관 번들, 에이전트의 등록 클라이언트 인증서 및 키가 포함되어 있습니다. 다음 예제를 참조하십시오.

   enrollment-service:
     authentication:
       client-certificate-data: LS0tLS1CRUdJTiBD...
       client-key-data: LS0tLS1CRUdJTiBF...
     service:
       certificate-authority-data: LS0tLS1CRUdJTiBD...
       server: https://agent-api.flightctl.127.0.0.1.nip.io:7443
     enrollment-ui-endpoint: https://ui.flightctl.127.0.0.1.nip.io:8081

   Copy to Clipboard Toggle word wrap

프로세스

1. 사용하는 컨테이너 이미지의 종류에 따라 장치의 다음 시스템 경로 중 하나 또는 둘 다에 풀 시크릿을 배치합니다.

   • 운영 체제 이미지는 /etc/ostree/auth.json 경로를 사용합니다.

   • 애플리케이션 컨테이너 이미지는 /root/.config/containers/auth.json 경로를 사용합니다.

     중요

     시크릿을 사용하기 전에 가져오기 보안이 장치에 있어야 합니다.

2. 풀 시크릿에서 다음 형식을 사용하는지 확인합니다.

   {
     "auths": {
       "registry.example.com": {
         "auth": "base64-encoded-credentials"
       }
     }
   }

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 내용으로 Containerfile 파일을 생성하여 Red Hat Edge Manager 에이전트 및 구성이 포함된 RHEL 9 기반 운영 체제 이미지를 빌드합니다.

   FROM registry.redhat.io/rhel9/rhel-bootc:<required_os_version> 

   1

   
   RUN dnf --enablerepo ansible-automation-platform-2.5-for-rhel-9-x86_64-rpms -y install flightctl-agent-0.7.2-1.el9fc  && \
       dnf -y clean all && \
       systemctl enable flightctl-agent.service && \
       systemctl mask bootc-fetch-apply-updates.timer  

   2

   Copy to Clipboard Toggle word wrap

   1

   FROM 에서 참조된 기본 이미지는 이미 Linux 커널이 있는 부팅 가능한 컨테이너(bootc) 이미지이며 기존 표준 컨테이너 빌드 툴 및 워크플로우를 재사용할 수 있습니다.

   2

   기본 자동 업데이트를 비활성화합니다. 업데이트는 Red Hat Edge Manager에서 관리합니다.

   중요

   장치가 프라이빗 리포지토리의 컨테이너에 의존하는 경우 /etc/ostree/auth.json 경로에 장치 풀 시크릿을 배치해야 합니다. 시크릿을 사용하기 전에 가져오기 보안이 장치에 있어야 합니다.

   • 선택 사항: podman-compose 애플리케이션 지원을 활성화하려면 Containerfile 파일에 다음 섹션을 추가합니다.

     RUN dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm && \
         dnf -y install podman-compose && \
         dnf -y clean all && \
         systemctl enable podman.service

     Copy to Clipboard Toggle word wrap

   • 선택 사항: 초기 바인딩에 대해 config.yaml 을 생성한 경우 Containerfile 에 다음 섹션을 추가합니다.

     ADD config.yaml /etc/flightctl/

     Copy to Clipboard Toggle word wrap

   자세한 내용은 선택 사항: 조기 바인딩에 대한 등록 인증서 요청을 참조하십시오.

2. 다음 명령을 실행하여 OCI(Open Container Initiative) 레지스트리를 정의합니다.

   OCI_REGISTRY=registry.redhat.io

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 작성할 권한이 있는 이미지 리포지토리를 정의합니다.

   OCI_IMAGE_REPO=${OCI_REGISTRY}/<your_org>/<your_image>

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 이미지 태그를 정의합니다.

   OCI_IMAGE_TAG=v1

   Copy to Clipboard Toggle word wrap

5. 대상 플랫폼의 운영 체제 이미지를 빌드합니다.

   sudo podman build -t ${OCI_IMAGE_REPO}:${OCI_IMAGE_TAG} .

   Copy to Clipboard Toggle word wrap

프로세스

1. signingkey.pub 및 signingkey.private:이라는 Sigstore 키 쌍을 생성합니다.

   skopeo generate-sigstore-key --output-prefix signingkey

   Copy to Clipboard Toggle word wrap

2. 서명된 이미지와 함께 Sigstore 서명을 OCI 레지스트리에 업로드하도록 Podman 및 Skopeo와 같은 컨테이너 툴을 구성합니다.

   sudo tee "/etc/containers/registries.d/${OCI_REGISTRY}.yaml" > /dev/null <<EOF
   docker:
       ${OCI_REGISTRY}:
           use-sigstore-attachments: true
   EOF

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 OCI 레지스트리에 로그인합니다.

   sudo podman login ${OCI_REGISTRY}

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 운영 체제 이미지에 서명하고 게시합니다.

   sudo podman push \
       --sign-by-sigstore-private-key ./signingkey.private \
       ${OCI_IMAGE_REPO}:${OCI_IMAGE_TAG}

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 출력 이라는 디렉터리를 생성합니다.

   mkdir -p output

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 운영 체제 이미지에서 iso 유형의 운영 체제 디스크 이미지를 생성하려면 bootc-image-builder 를 사용합니다.

   sudo podman run --rm -it --privileged --pull=newer \
       --security-opt label=type:unconfined_t \
       -v "${PWD}/output":/output \
       -v /var/lib/containers/storage:/var/lib/containers/storage \
       registry.redhat.io/rhel9/bootc-image-builder:latest \
       --type iso \
       ${OCI_IMAGE_REPO}:${OCI_IMAGE_TAG}

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 ISO 디스크 이미지가 있는 디렉터리의 소유자를 root 에서 현재 사용자로 변경합니다.

   sudo chown -R $(whoami):$(whoami) "${PWD}/output"

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 /diskimage-iso 가 추가된 bootc 이미지와 동일한 리포지토리가 되도록 OCI_DISK_IMAGE_REPO 환경 변수를 정의합니다.

   OCI_DISK_IMAGE_REPO=${OCI_IMAGE_REPO}/diskimage-iso

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 매니페스트 목록을 생성합니다.

   sudo podman manifest create \
       ${OCI_DISK_IMAGE_REPO}:${OCI_IMAGE_TAG}

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 매니페스트 목록에 ISO 디스크 이미지를 OCI 아티팩트로 추가합니다.

   sudo podman manifest add \
       --artifact --artifact-type application/vnd.diskimage.iso \
       --arch=amd64 --os=linux \
       ${OCI_DISK_IMAGE_REPO}:${OCI_IMAGE_TAG} \
       "${PWD}/output/bootiso/install.iso"

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 프라이빗 Sigstore 키를 사용하여 매니페스트 목록에 서명하고 레지스트리에 이미지를 푸시합니다.

   sudo podman manifest push --all \
        --sign-by-sigstore-private-key ./signingkey.private \
       ${OCI_DISK_IMAGE_REPO}:${OCI_IMAGE_TAG} \
       docker://${OCI_DISK_IMAGE_REPO}:${OCI_IMAGE_TAG}

   Copy to Clipboard Toggle word wrap