9장. MicroShift 애플리케이션 포함 튜토리얼
다음 튜토리얼에서는 다양한 환경의 MicroShift 노드에서 사용하기 위해 RHEL for Edge 이미지에 애플리케이션을 포함하는 방법을 자세히 보여줍니다.
9.1. 애플리케이션 RPM 튜토리얼 포함 링크 복사링크가 클립보드에 복사되었습니다!
다음 튜토리얼에서는 MicroShift 설치 단계를 검토하고 애플리케이션 포함을 위한 워크플로에 대한 설명을 추가합니다. Red Hat Enterprise Linux for Edge(RHEL for Edge) 및 MicroShift와 같은 rpm-ostree 시스템에 이미 익숙한 경우 절차를 바로 진행할 수 있습니다.
9.1.1. 설치 워크플로 검토 링크 복사링크가 클립보드에 복사되었습니다!
애플리케이션을 삽입하려면 마이크로Shift를 RHEL for Edge 이미지에 포함하기 위해 유사한 워크플로우가 필요합니다.
- 다음 이미지는 RPM, 컨테이너 및 파일과 같은 시스템 아티팩트를 블루프린트에 추가하고 이미지 작성자가 ostree 커밋을 생성하는 방법을 보여줍니다.
- 그런 다음 ostree 커밋은 ISO 경로 또는 에지 장치의 리포지토리 경로를 따를 수 있습니다.
- ISO 경로는 연결이 끊긴 환경에 사용할 수 있지만 리포지토리 경로는 일반적으로 네트워크가 연결되어 있는 위치에서 사용됩니다.
다음 단계를 검토하면 애플리케이션을 포함하는 데 필요한 단계를 이해하는 데 도움이 될 수 있습니다.
- RHEL for Edge에 MicroShift를 포함하려면 이미지 빌더에 MicroShift 리포지토리를 추가했습니다.
- MicroShift 추가를 포함하여 필요한 모든 RPM, 컨테이너 이미지, 파일 및 사용자 정의를 선언한 블루프린트를 생성했습니다.
-
이미지 빌더에 블루프린트를 추가하고 이미지 빌더 CLI 툴(
composer-cli)을 사용하여 빌드를 실행했습니다. 이 단계에서는 컨테이너 이미지를 생성하는 데 사용되는rpm-ostree커밋이 생성되었습니다. 이 이미지에는 RHEL for Edge가 포함되어 있습니다. -
설치 ISO의 블루프린트를 이미지 빌더에 추가하여 부팅할
rpm-ostree이미지(ISO)를 생성합니다. 이 빌드에는 RHEL for Edge 및 MicroShift가 모두 포함되어 있습니다. - MicroShift가 내장된 ISO를 다운로드하여 이를 사용할 수 있도록 준비한 다음 에지 장치에 설치되었습니다.
9.1.2. 애플리케이션 RPM 워크플로 포함 링크 복사링크가 클립보드에 복사되었습니다!
이미지 빌더 요구 사항을 충족하는 빌드 호스트를 설정한 후 매니페스트 디렉터리의 형태로 애플리케이션을 이미지에 추가할 수 있습니다. 이러한 단계를 수행한 후 애플리케이션 또는 워크로드를 새 ISO에 포함하는 가장 간단한 방법은 매니페스트를 포함하는 자체 RPM을 생성하는 것입니다. 애플리케이션 RPM에는 배포를 설명하는 모든 구성 파일이 포함되어 있습니다.
다음 "애플리케이션 워크플로 통합" 이미지는 Kubernetes 애플리케이션 매니페스트 및 RPM 사양 파일이 단일 애플리케이션 RPM 빌드에서 결합하는 방법을 보여줍니다. 이 빌드는 ostree 커밋에 MicroShift를 포함하기 위한 워크플로우에 포함된 RPM 아티팩트가 됩니다.
다음 절차에서는 rpmbuild 툴을 사용하여 사양 파일 및 로컬 리포지토리를 생성합니다. 사양 파일은 패키지 빌드 방법을 정의하여 애플리케이션 매니페스트를 MicroShift용 RPM 패키지 내의 올바른 위치로 이동하여 이를 선택합니다. 그런 다음 해당 RPM 패키지가 ISO에 포함됩니다.
9.1.3. 애플리케이션 RPM 준비 링크 복사링크가 클립보드에 복사되었습니다!
자체 RPM을 빌드하려면 rpmbuild 툴과 같은 툴을 선택하고 홈 디렉토리에서 RPM 빌드 트리를 초기화합니다. 이미지 빌더에서 RPM에 액세스할 수 있는 경우 애플리케이션 RPM을 빌드하는 데 원하는 방법을 사용할 수 있습니다.
다음은 예제 절차입니다.
사전 요구 사항
- 이미지 빌더 시스템 요구 사항을 충족하는 RHEL for Edge(RHEL for Edge) 9.8 빌드 호스트를 설정했습니다.
- 호스트에 대한 root 액세스 권한이 있습니다.
절차
rpmbuild툴을 설치하고 다음 명령을 실행하여 yum 리포지토리를 생성합니다.$ sudo dnf install rpmdevtools rpmlint yum-utils createrepo다음 명령을 실행하여 RPM 패키지를 빌드하는 데 필요한 파일 트리를 만듭니다.
$ rpmdev-setuptree
검증
다음 명령을 실행하여 생성을 확인할 디렉터리를 나열합니다.
$ ls ~/rpmbuild/출력 예
BUILD RPMS SOURCES SPECS SRPMS
9.1.4. 애플리케이션 매니페스트용 RPM 패키지 빌드 링크 복사링크가 클립보드에 복사되었습니다!
자체 RPM을 빌드하려면 애플리케이션 매니페스트를 RPM 패키지에 추가하는 사양 파일을 생성해야 합니다. 이미지 빌더에서 애플리케이션 RPM 및 이미지 빌드에 필요한 기타 요소에 액세스할 수 있는 경우 원하는 방법을 사용할 수 있습니다.
다음은 예제 절차입니다.
사전 요구 사항
- 이미지 빌더 시스템 요구 사항을 충족하는 RHEL for Edge(RHEL for Edge) 9.8 빌드 호스트를 설정했습니다.
- 호스트에 대한 root 액세스 권한이 있습니다.
- RPM 패키지를 빌드하는 데 필요한 파일 트리가 생성되었습니다.
절차
~/rpmbuild/SPECS디렉터리에서 다음 템플릿을 사용하여 <application_workload_manifests.spec>과 같은 파일을 생성합니다.spec 파일 예
Name: <application_workload_manifests> Version: 0.0.1 Release: 1%{?dist} Summary: Adds workload manifests to microshift BuildArch: noarch License: GPL Source0: %{name}-%{version}.tar.gz #Requires: microshift %description Adds workload manifests to microshift %prep %autosetup %install rm -rf $RPM_BUILD_ROOT mkdir -p $RPM_BUILD_ROOT/%{prefix}/lib/microshift/manifests cp -pr ~/manifests $RPM_BUILD_ROOT/%{_prefix}/lib/microshift/ %clean rm -rf $RPM_BUILD_ROOT %files %{_prefix}/lib/microshift/manifests/** %changelog * _<DDD MM DD YYYY username@domain - V major.minor.patch> - <your_change_log_comment>%install섹션은 RPM 패키지/usr/lib/microshift/manifests/내에 대상 디렉터리를 생성하고 소스 홈 디렉터리~/manifests에서 매니페스트를 복사합니다.중요필요한 YAML 파일은 모두 kustomize를 사용하는 경우
kustomize.yaml파일을 포함하여 소스 홈 디렉터리~/manifests에 있어야 합니다.다음 명령을 실행하여
~/rpmbuild/RPMS디렉터리에 RPM 패키지를 빌드합니다.$ rpmbuild -bb ~/rpmbuild/SPECS/<application_workload_manifests.spec>
9.1.5. 블루프린트에 애플리케이션 RPM 추가 링크 복사링크가 클립보드에 복사되었습니다!
MicroShift의 블루프린트에 애플리케이션 RPM을 추가하려면 이미지 빌더가 ISO를 생성하는 데 사용할 수 있는 로컬 리포지토리를 생성해야 합니다. 이 절차를 통해 워크로드에 필요한 컨테이너 이미지를 네트워크를 통해 가져올 수 있습니다.
사전 요구 사항
- 호스트에 대한 root 액세스 권한이 있습니다.
-
워크로드 또는 애플리케이션 RPM은
~/rpmbuild/RPMS디렉터리에 있습니다.
절차
다음 명령을 실행하여 로컬 RPM 리포지토리를 생성합니다.
$ createrepo ~/rpmbuild/RPMS/다음 명령을 실행하여 RPM 리포지토리에 이미지 빌더 액세스 권한을 부여합니다.
$ sudo chmod a+rx ~이미지 빌더에 이미지 빌드에 필요한 모든 파일에 액세스하는 데 필요한 모든 권한이 있는지 또는 빌드를 진행할 수 없는지 확인해야 합니다.
다음 템플릿을 사용하여 블루프린트 파일
repo-local-rpmbuild.toml를 생성합니다.id = "local-rpm-build" name = "RPMs build locally" type = "yum-baseurl" url = "file://<path>/rpmbuild/RPMS" check_gpg = false check_ssl = false system = false&
lt;path>를 선택한 위치를 생성할 경로로 바꿉니다. 이 경로는 이 절차의 이후 명령에서 리포지토리를 설정하고 RPM을 복사하는 데 사용됩니다.다음 명령을 실행하여 리포지토리를 이미지 빌더 소스로 추가합니다.
$ sudo composer-cli sources add repo-local-rpmbuild.toml다음 행을 추가하여 블루프린트에 RPM을 추가합니다.
… [[packages]] name = "<application_workload_manifests>" version = "*" …&
lt;application_workload_manifests>를 워크로드 이름으로 바꿉니다.다음 명령을 실행하여 업데이트된 블루프린트를 이미지 빌더로 푸시합니다.
$ sudo composer-cli blueprints push repo-local-rpmbuild.toml이 시점에서 이미지 빌더를 실행하여 ISO를 생성하거나 오프라인에서 사용할 컨테이너 이미지를 포함할 수 있습니다.
ISO를 생성하려면 다음 명령을 실행하여 이미지 빌더를 시작합니다.
$ sudo composer-cli compose start-ostree repo-local-rpmbuild edge-commit이 시나리오에서는 시작 중에 에지 장치에 의해 컨테이너 이미지를 네트워크를 통해 가져옵니다.