설치
1장. {builds-shortname} 설치 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 관리자는 OpenShift Container Platform 클러스터에 Red Hat OpenShift의 빌드를 설치할 수 있습니다.
1.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
- OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.
-
ocCLI를 설치했습니다. - OpenShift Container Platform 클러스터에 관리자로 로그인되어 있습니다.
- 클러스터에 Marketplace 기능이 활성화되어 있거나 Red Hat Operator 카탈로그 소스가 수동으로 구성되어 있습니다.
종속성 구성 요소로 Red Hat OpenShift Pipelines Operator는 설치 중에 Red Hat OpenShift Operator 빌드와 함께 자동으로 설치됩니다. Red Hat OpenShift Pipelines Operator를 이미 설치한 경우 Builds는 해당 Operator를 사용하여 작동합니다.
1.2. 웹 콘솔을 사용하여 빌드 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔을 사용하여 OperatorHub에서 Red Hat OpenShift Operator 빌드를 설치할 수 있습니다. 이 Operator를 설치하면 빌드 구성 요소를 설치하고 사용할 수 있습니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Operator → OperatorHub 페이지로 이동합니다.
- 키워드로 필터링 상자를 사용하여 카탈로그에서 Red Hat OpenShift Operator 빌드를 검색합니다.
- Red Hat OpenShift Operator 타일 빌드를 클릭합니다.
- Operator에 대한 간략한 설명을 읽고 설치를 클릭합니다.
Operator 설치 페이지에서 다음을 수행합니다.
-
설치 모드가 클러스터의 모든 네임스페이스(기본값) 로 설정되어 있는지 확인합니다. 이 모드는 기본
openshift-operators네임스페이스에 Operator를 설치하여 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있도록 합니다. -
설치된 네임스페이스 가 기본적으로
openshift-operators로 설정되어 있는지 확인합니다. - Approval Strategy으로 Automatic을 선택합니다. 그러면 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다. Manual 승인 전략을 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.
채널 업데이트 선택:
- 업데이트 채널은 기본적으로 latest 로 설정됩니다. 최신 채널을 사용하면 Red Hat OpenShift Operator용 최신 버전의 빌드 버전을 설치할 수 있습니다.
-
Red Hat OpenShift Operator의 특정 버전의 빌드를 설치하려면 클러스터 관리자가 해당
openshift-builds-<version> 채널을 사용할 수 있습니다. 예를 들어 Red Hat OpenShift Operator 버전0.11.0의 빌드를 설치하려면openshift-builds-0.11.0채널을 사용할 수 있습니다.
-
설치 모드가 클러스터의 모든 네임스페이스(기본값) 로 설정되어 있는지 확인합니다. 이 모드는 기본
- 설치를 클릭합니다.
검증
- 설치된 Operator 페이지에서 Red Hat OpenShift Operator 빌드가 나열되고 설치가 성공으로 설정되어 있는지 확인합니다.
1.2.1. 웹 콘솔을 사용하여 shipwrightBuild 리소스 생성 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Operator 빌드를 설치한 후 빌드 컨트롤러의 기능을 활성화하려면 shipwrightBuild 리소스를 생성해야 합니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator 페이지로 이동합니다.
- 목록에 있는 Red Hat OpenShift Operator 빌드 링크를 클릭합니다. Operator 세부 정보 페이지가 열립니다.
- shipwright Build 탭을 선택하고 Create ShipwrightBuild 를 클릭합니다.
양식 보기 또는 YAML 보기를 선택하여 다음과 같은 방식으로 새
ShipwrightBuild리소스를 구성합니다.양식 보기 또는 YAML 보기를 선택하면
name및targetNamespace필드에 대해 구성된 기본값이 표시됩니다. 해당 필드를 편집하지 않으려면 생성 을 클릭하여shipwrightBuild리소스를 기본값으로 구성합니다.생성된 리소스를 shipwright Build 탭에서 볼 수 있습니다.
검증
- 컨트롤러 Pod가 언급된 대상 네임스페이스에 생성되어 있어야 합니다.
1.3. CLI를 사용하여 빌드 설치 링크 복사링크가 클립보드에 복사되었습니다!
CLI를 사용하여 Red Hat OpenShift용 빌드를 설치할 수도 있습니다.
프로세스
다음 예와 같이
sub.yaml서브스크립션 오브젝트 파일을 생성하여 Red Hat OpenShift Operator 빌드에 네임스페이스를 등록합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 서브스크립션 오브젝트를 적용합니다.
oc apply -f sub.yml
$ oc apply -f sub.ymlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 이제 Red Hat OpenShift Operator 빌드가 기본 대상 네임스페이스
openshift-operators에 설치됩니다.
1.3.1. CLI를 사용하여 shipwrightBuild 리소스 생성 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Operator 빌드를 설치한 후 빌드 컨트롤러의 기능을 활성화하려면 shipwrightBuild 리소스를 생성해야 합니다.
프로세스
다음 예와 같이
instance.yaml파일을 생성하여리소스를 생성합니다.shipwright-builds네임스페이스에 shipwrightBuildCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 YAML 파일을 적용합니다.
oc apply -f instance.yaml
$ oc apply -f instance.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여
shipwrightBuild 리소스가이제 구성되었는지 확인합니다.oc get pods -n shipwright-builds
$ oc get pods -n shipwright-buildsCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2장. 샘플 빌드 전략 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터에 빌드 전략 또는 클러스터 빌드 전략을 설치할 수 있습니다. ClusterBuildStrategy 리소스는 클러스터 전체에서 사용할 수 있으며 네임 스페이스 내에서 BuildStrategy 리소스를 사용할 수 있습니다.
Red Hat OpenShift용 빌드에서는 다음 클러스터 빌드 전략을 지원합니다.
-
Buildah: 모든 플랫폼에서 지원 -
S2I(Source-to-Image) : linux/amd64 플랫폼에서 지원
buildpacks 빌드 전략은 현재 개발자 프리뷰 에 있습니다.
2.1. Buildah 링크 복사링크가 클립보드에 복사되었습니다!
buildah 클러스터 빌드 전략에서는 Dockerfile을 사용하여 컨테이너 이미지를 빌드하고 내보냅니다. Build CR에서 Dockerfile을 지정해야 합니다.
buildah 전략을 클러스터 수준에서 설치할 수 있습니다.
2.1.1. buildah 전략 설치 링크 복사링크가 클립보드에 복사되었습니다!
buildah 클러스터 빌드 전략을 설치할 수 있습니다. 이 전략은 데몬을 실행할 필요가 없으며 권한이 없는 사용자가 사용할 수 있습니다. buildah 를 설치하기 위해 buildah-strategy-managed-push 리소스를 사용하면 추가 처리 없이 이미지를 대상 리포지토리로 푸시할 수 있습니다.
사전 요구 사항
-
ocCLI를 설치했습니다.
프로세스
buildah전략을 설치하려면 다음 명령을 실행합니다.oc apply -f https://raw.githubusercontent.com/shipwright-io/build/main/samples/buildstrategy/buildah/buildstrategy_buildah_strategy_managed_push_cr.yaml
$ oc apply -f https://raw.githubusercontent.com/shipwright-io/build/main/samples/buildstrategy/buildah/buildstrategy_buildah_strategy_managed_push_cr.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2. S2I(Source-to-Image) 링크 복사링크가 클립보드에 복사되었습니다!
이 빌드 전략은 S2I( Source-to-Image) 및 buildah 전략으로 구성됩니다. 이 전략을 사용하여 컨테이너 파일을 생성하고 빌더 이미지로 빌드할 애플리케이션을 준비할 수 있습니다.
S 2I(Source-to- Image) 전략에는 Build CR의 spec.paramValues 필드에서 매개변수로 전달할 수 있는 특수하게 조작된 빌더 이미지가 필요합니다.
2.2.1. S2I(Source-to-Image) 전략 설치 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 수준에서 S2I (Source-to-Image ) 전략을 설치할 수 있습니다. 클러스터 수준에서 클러스터를 설치하여 클러스터 내 다른 네임스페이스에서 S2I(Source -to-Image ) 전략을 공유할 수 있습니다.
사전 요구 사항
-
ocCLI를 설치했습니다.
프로세스
클러스터 수준에서 S
2I(Source-to-Image) 전략을 설치하려면 다음 명령을 실행합니다.oc apply -f https://raw.githubusercontent.com/shipwright-io/build/main/samples/buildstrategy/source-to-image/buildstrategy_source-to-image-redhat_cr.yaml
$ oc apply -f https://raw.githubusercontent.com/shipwright-io/build/main/samples/buildstrategy/source-to-image/buildstrategy_source-to-image-redhat_cr.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Legal Notice
링크 복사링크가 클립보드에 복사되었습니다!
Copyright © 2025 Red Hat
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.