설치


builds for Red Hat OpenShift 1.0

빌드 설치

Red Hat OpenShift Documentation Team

초록

이 문서에서는 빌드 설치에 대한 정보를 제공합니다.

1장. {builds-shortname} 설치

클러스터 관리자는 OpenShift Container Platform 클러스터에 Red Hat OpenShift의 빌드를 설치할 수 있습니다.

1.1. 사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.
  • oc CLI를 설치했습니다.
  • 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를 설치하면 빌드 구성 요소를 설치하고 사용할 수 있습니다.

프로세스

  1. 웹 콘솔의 관리자 화면에서 OperatorOperatorHub 페이지로 이동합니다.
  2. 키워드로 필터링 상자를 사용하여 카탈로그에서 Red Hat OpenShift Operator 빌드를 검색합니다.
  3. Red Hat OpenShift Operator 타일 빌드를 클릭합니다.
  4. Operator에 대한 간략한 설명을 읽고 설치를 클릭합니다.
  5. Operator 설치 페이지에서 다음을 수행합니다.

    1. 설치 모드가 클러스터의 모든 네임스페이스(기본값) 로 설정되어 있는지 확인합니다. 이 모드는 기본 openshift-operators 네임스페이스에 Operator를 설치하여 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있도록 합니다.
    2. 설치된 네임스페이스 가 기본적으로 openshift-operators 로 설정되어 있는지 확인합니다.
    3. Approval Strategy으로 Automatic을 선택합니다. 그러면 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다. Manual 승인 전략을 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.
    4. 채널 업데이트 선택:

      • 업데이트 채널은 기본적으로 latest 로 설정됩니다. 최신 채널을 사용하면 Red Hat OpenShift Operator용 최신 버전의 빌드 버전을 설치할 수 있습니다.
      • Red Hat OpenShift Operator의 특정 버전의 빌드를 설치하려면 클러스터 관리자가 해당 openshift-builds-<version > 채널을 사용할 수 있습니다. 예를 들어 Red Hat OpenShift Operator 버전 0.11.0 의 빌드를 설치하려면 openshift-builds-0.11.0 채널을 사용할 수 있습니다.
  6. 설치를 클릭합니다.

검증

  • 설치된 Operator 페이지에서 Red Hat OpenShift Operator 빌드가 나열되고 설치가 성공으로 설정되어 있는지 확인합니다.

1.2.1. 웹 콘솔을 사용하여 shipwrightBuild 리소스 생성

Red Hat OpenShift Operator 빌드를 설치한 후 빌드 컨트롤러의 기능을 활성화하려면 shipwrightBuild 리소스를 생성해야 합니다.

프로세스

  1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator 페이지로 이동합니다.
  2. 목록에 있는 Red Hat OpenShift Operator 빌드 링크를 클릭합니다. Operator 세부 정보 페이지가 열립니다.
  3. shipwright Build 탭을 선택하고 Create ShipwrightBuild 를 클릭합니다.
  4. 양식 보기 또는 YAML 보기를 선택하여 다음과 같은 방식으로 새 ShipwrightBuild 리소스를 구성합니다.

    • 양식 보기 또는 YAML 보기를 선택하면 nametargetNamespace 필드에 대해 구성된 기본값이 표시됩니다. 해당 필드를 편집하지 않으려면 생성 을 클릭하여 shipwrightBuild 리소스를 기본값으로 구성합니다.

      생성된 리소스를 shipwright Build 탭에서 볼 수 있습니다.

검증

  • 컨트롤러 Pod가 언급된 대상 네임스페이스에 생성되어 있어야 합니다.

1.3. CLI를 사용하여 빌드 설치

CLI를 사용하여 Red Hat OpenShift용 빌드를 설치할 수도 있습니다.

프로세스

  1. 다음 예와 같이 sub.yaml 서브스크립션 오브젝트 파일을 생성하여 Red Hat OpenShift Operator 빌드에 네임스페이스를 등록합니다.

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: openshift-builds-operator
      namespace: openshift-operators
    spec:
      channel: <channel-name> 
    1
    
      name: openshift-builds-operator 
    2
    
      source: redhat-operators 
    3
    
      sourceNamespace: openshift-marketplace 
    4
    Copy to Clipboard Toggle word wrap
    1
    Operator를 서브스크립션할 채널 이름입니다.
    2
    등록할 Operator의 이름입니다.
    3
    Operator를 제공하는 CatalogSource의 이름입니다.
    4
    CatalogSource의 네임스페이스입니다. 기본 OperatorHub CatalogSources에는 openshift-marketplace를 사용합니다.
  2. 다음 명령을 실행하여 서브스크립션 오브젝트를 적용합니다.

    $ oc apply -f sub.yml
    Copy to Clipboard Toggle word wrap

    이제 Red Hat OpenShift Operator 빌드가 기본 대상 네임스페이스 openshift-operators 에 설치됩니다.

1.3.1. CLI를 사용하여 shipwrightBuild 리소스 생성

Red Hat OpenShift Operator 빌드를 설치한 후 빌드 컨트롤러의 기능을 활성화하려면 shipwrightBuild 리소스를 생성해야 합니다.

프로세스

  1. 다음 예와 같이 instance.yaml 파일을 생성하여 shipwright-builds 네임스페이스에 shipwrightBuild 리소스를 생성합니다.

    apiVersion: operator.shipwright.io/v1beta1
    kind: ShipwrightBuild
    metadata:
      name: shipwright-build
    spec:
      targetNamespace: shipwright-builds
    Copy to Clipboard Toggle word wrap
  2. 다음 명령을 실행하여 YAML 파일을 적용합니다.

    $ oc apply -f instance.yaml
    Copy to Clipboard Toggle word wrap

검증

  • 다음 명령을 실행하여 shipwrightBuild 리소스가 이제 구성되었는지 확인합니다.

    $ oc get pods -n shipwright-builds
    Copy to Clipboard Toggle word wrap

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 리소스를 사용하면 추가 처리 없이 이미지를 대상 리포지토리로 푸시할 수 있습니다.

사전 요구 사항

  • oc CLI를 설치했습니다.

프로세스

  • buildah 전략을 설치하려면 다음 명령을 실행합니다.

    $ oc apply -f https://raw.githubusercontent.com/shipwright-io/build/main/samples/buildstrategy/buildah/buildstrategy_buildah_strategy_managed_push_cr.yaml
    Copy to Clipboard Toggle word wrap

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 ) 전략을 공유할 수 있습니다.

사전 요구 사항

  • oc CLI를 설치했습니다.

프로세스

  • 클러스터 수준에서 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
    Copy to Clipboard Toggle word wrap

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.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat