9.3. OpenShift Container Platform을 사용하여 Red Hat Quay 빌더 환경 생성

절차

1. 클러스터 관리자 계정을 사용하여 Red Hat Quay 클러스터에 로그인합니다.

2. 다음 명령을 실행하여 가상 빌더가 실행될 새 프로젝트를 생성합니다(예: virtual-builders ).

   $ oc new-project virtual-builders

3. 다음 명령을 입력하여 빌드를 실행하는 데 사용할 프로젝트에 ServiceAccount 를 생성합니다.

   $ oc create sa -n virtual-builders quay-builder

4. 빌드를 실행할 수 있도록 편집 권한이 생성된 서비스 계정을 제공합니다.

   $ oc adm policy -n virtual-builders add-role-to-user edit system:serviceaccount:virtual-builders:quay-builder

5. 다음 명령을 입력하여 Quay 빌더 anyuid scc 권한을 부여합니다.

   $ oc adm policy -n virtual-builders add-scc-to-user anyuid -z quay-builder

   참고

   이 작업을 수행하려면 클러스터 관리자 권한이 필요합니다. 이는 권한이 없거나 rootless 빌드가 작동하려면 빌더를 Podman 사용자로 실행해야 하므로 필요합니다.

6. Quay 빌더 서비스 계정의 토큰을 가져옵니다.

   1. OpenShift Container Platform 4.10 또는 이전 버전을 사용하는 경우 다음 명령을 입력합니다.

      oc sa get-token -n virtual-builders quay-builder

   2. OpenShift Container Platform 4.11 이상을 사용하는 경우 다음 명령을 입력합니다.

      $ oc create token quay-builder -n virtual-builders

      출력 예

      eyJhbGciOiJSUzI1NiIsImtpZCI6IldfQUJkaDVmb3ltTHZ0dGZMYjhIWnYxZTQzN2dJVEJxcDJscldSdEUtYWsifQ...

7. 다음 명령을 입력하여 빌더 경로를 결정합니다.

   $ oc get route -n quay-enterprise

   출력 예

   NAME                                  HOST/PORT                                                                    PATH   SERVICES                              PORT   TERMINATION     WILDCARD
   ...
   example-registry-quay-builder         example-registry-quay-builder-quay-enterprise.apps.docs.quayteam.org                example-registry-quay-app             grpc   edge/Redirect   None
   ...

8. 다음 명령을 입력하여 .crt 확장을 사용하여 자체 서명된 SSL/TlS 인증서를 생성합니다.

   $ oc extract cm/kube-root-ca.crt -n openshift-apiserver

   출력 예

   ca.crt

9. 다음 명령을 입력하여 ca.crt 파일의 이름을 extra_ca_cert_build_cluster.crt 로 변경합니다.

   $ mv ca.crt extra_ca_cert_build_cluster.crt

10. 콘솔에서 구성 번들의 시크릿을 찾고 작업 시크릿 편집 을 선택하고 적절한 빌더 구성을 추가합니다.

    FEATURE_USER_INITIALIZE: true
    BROWSER_API_CALLS_XHR_ONLY: false
    SUPER_USERS:
    - <superusername>
    FEATURE_USER_CREATION: false
    FEATURE_QUOTA_MANAGEMENT: true
    FEATURE_BUILD_SUPPORT: True
    BUILDMAN_HOSTNAME: <sample_build_route> 

    1

    
    BUILD_MANAGER:
      - ephemeral
      - ALLOWED_WORKER_COUNT: 1
        ORCHESTRATOR_PREFIX: buildman/production/
        JOB_REGISTRATION_TIMEOUT: 3600 

    2

    
        ORCHESTRATOR:
          REDIS_HOST: <sample_redis_hostname> 

    3

    
          REDIS_PASSWORD: ""
          REDIS_SSL: false
          REDIS_SKIP_KEYSPACE_EVENT_SETUP: false
        EXECUTORS:
          - EXECUTOR: kubernetesPodman
            NAME: openshift
            BUILDER_NAMESPACE: <sample_builder_namespace> 

    4

    
            SETUP_TIME: 180
            MINIMUM_RETRY_THRESHOLD: 0
            BUILDER_CONTAINER_IMAGE: <sample_builder_container_image> 

    5

    
            # Kubernetes resource options
            K8S_API_SERVER: <sample_k8s_api_server> 

    6

    
            K8S_API_TLS_CA: <sample_crt_file> 

    7

    
            VOLUME_SIZE: 8G
            KUBERNETES_DISTRIBUTION: openshift
            CONTAINER_MEMORY_LIMITS: 300m 

    8

    
            CONTAINER_CPU_LIMITS: 1G 

    9

    
            CONTAINER_MEMORY_REQUEST: 300m 

    10

    
            CONTAINER_CPU_REQUEST: 1G 

    11

    
            NODE_SELECTOR_LABEL_KEY: ""
            NODE_SELECTOR_LABEL_VALUE: ""
            SERVICE_ACCOUNT_NAME: <sample_service_account_name>
            SERVICE_ACCOUNT_TOKEN: <sample_account_token> 

    12

    1

    빌드 경로는 oc get route -n 을 OpenShift Operator의 네임스페이스 이름으로 실행하여 가져옵니다. 포트는 경로 마지막에 제공되어야 하며 [quayregistry-cr-name]-quay-builder-[ocp-namespace].[ocp-domain-name]:443 이라는 형식을 사용해야 합니다.

    2

    JOB_REGISTRATION_TIMEOUT 매개변수가 너무 낮으면 다음과 같은 오류가 발생할 수 있습니다: failed to register job to build manager:ECDHE error: code = Unauthenticated desc = Invalid build token: signature has expired. 이 매개 변수는 최소 CloudEvent로 설정되는 것이 좋습니다.

    3

    Redis 호스트에 암호 또는 SSL/TLS 인증서가 있는 경우 적절하게 업데이트해야 합니다.

    4

    가상 빌더 네임스페이스의 이름과 일치하도록 설정합니다(예: virtual-builders ).

    5

    초기 액세스의 경우 BUILDER_CONTAINER_IMAGE 는 현재 quay.io/projectquay/quay-builder:3.7.0-rc.2 입니다. 초기 액세스 기간 동안 변경될 수 있습니다. 이 경우 고객에게 경고를 발행합니다.

    6

    K8S_API_SERVER 는 oc cluster-info 를 실행하여 가져옵니다.

    7

    사용자 정의 CA 인증서를 수동으로 생성하고 추가해야 합니다(예: K8S_API_TLS_CA: /conf/stack/extra_ca_certs/build_cluster.crt ).

    8

    지정되지 않은 경우 기본값은 5120Mi 입니다.

    9

    가상 빌드의 경우 클러스터에 리소스가 충분한지 확인해야 합니다. 지정되지 않은 경우 기본값은 1000m 입니다.

    10

    지정되지 않은 경우 기본값은 3968Mi 입니다.

    11

    지정되지 않은 경우 기본값은 500m 입니다.

    12

    oc create sa 를 실행할 때 가져옵니다.

    샘플 구성

    FEATURE_USER_INITIALIZE: true
    BROWSER_API_CALLS_XHR_ONLY: false
    SUPER_USERS:
    - quayadmin
    FEATURE_USER_CREATION: false
    FEATURE_QUOTA_MANAGEMENT: true
    FEATURE_BUILD_SUPPORT: True
    BUILDMAN_HOSTNAME: example-registry-quay-builder-quay-enterprise.apps.docs.quayteam.org:443
    BUILD_MANAGER:
      - ephemeral
      - ALLOWED_WORKER_COUNT: 1
        ORCHESTRATOR_PREFIX: buildman/production/
        JOB_REGISTRATION_TIMEOUT: 3600
        ORCHESTRATOR:
          REDIS_HOST: example-registry-quay-redis
          REDIS_PASSWORD: ""
          REDIS_SSL: false
          REDIS_SKIP_KEYSPACE_EVENT_SETUP: false
        EXECUTORS:
          - EXECUTOR: kubernetesPodman
            NAME: openshift
            BUILDER_NAMESPACE: virtual-builders
            SETUP_TIME: 180
            MINIMUM_RETRY_THRESHOLD: 0
            BUILDER_CONTAINER_IMAGE: quay.io/projectquay/quay-builder:3.7.0-rc.2
            # Kubernetes resource options
            K8S_API_SERVER: api.docs.quayteam.org:6443
            K8S_API_TLS_CA: /conf/stack/extra_ca_certs/build_cluster.crt
            VOLUME_SIZE: 8G
            KUBERNETES_DISTRIBUTION: openshift
            CONTAINER_MEMORY_LIMITS: 1G
            CONTAINER_CPU_LIMITS: 1080m
            CONTAINER_MEMORY_REQUEST: 1G
            CONTAINER_CPU_REQUEST: 580m
            NODE_SELECTOR_LABEL_KEY: ""
            NODE_SELECTOR_LABEL_VALUE: ""
            SERVICE_ACCOUNT_NAME: quay-builder
            SERVICE_ACCOUNT_TOKEN: "eyJhbGciOiJSUzI1NiIsImtpZCI6IldfQUJkaDVmb3ltTHZ0dGZMYjhIWnYxZTQzN2dJVEJxcDJscldSdEUtYWsifQ"

절차

1. Red Hat Quay 리포지토리에 로그인합니다.
2. Create New Repository 를 클릭하고 새 레지스트리(예: testrepo )를 생성합니다.

3. Repositories (리포지토리) 페이지의 탐색 창에서 Builds 탭을 클릭합니다. 또는 해당 URL을 직접 사용합니다.

   https://example-registry-quay-quay-enterprise.apps.docs.quayteam.org/repository/quayadmin/testrepo?tab=builds

   중요

   경우에 따라 빌더에 호스트 이름을 확인하는 데 문제가 있을 수 있습니다. 이 문제는 작업 오브젝트에 대해 dnsPolicy 가 default 로 설정되는 것과 관련이 있을 수 있습니다. 현재 이 문제에 대한 해결방법이 없습니다. 이 문제는 향후 Red Hat Quay 버전에서 해결될 예정입니다.

4. 빌드 트리거 생성 사용자 지정 Git 리포지토리 내보내기를 클릭합니다.

5. Git 리포지토리를 복제하는 데 사용되는 HTTPS 또는 SSH 스타일 URL을 입력한 다음 Continue 를 클릭합니다. 예를 들면 다음과 같습니다.

   https://github.com/gabriel-rh/actions_test.git

6. 분기 또는 태그 이름으로 태그 매니페스트를 확인한 다음 Continue 를 클릭합니다.
7. 트리거를 호출할 때 빌드할 Dockerfile의 위치를 입력하고(예: /Dockerfile ) 계속 을 클릭합니다.
8. Docker 빌드에 대한 컨텍스트 위치(예: / )를 입력하고 Continue 를 클릭합니다.
9. 필요한 경우 WebSocket 계정을 만듭니다. 그렇지 않으면 Continue 를 클릭합니다.
10. Continue 를 클릭하여 매개 변수를 확인합니다.
11. 빌드 페이지에서 트리거 이름의 옵션 아이콘을 클릭한 다음 지금 트리거 실행을 클릭합니다.
12. Git 리포지토리에서 커밋 SHA를 입력하고 Start Build 를 클릭합니다.

13. 빌드 기록 페이지에서 커밋을 클릭하거나 oc get pods -n virtual-builders 를 실행하여 빌드 상태를 확인할 수 있습니다. 예를 들면 다음과 같습니다.

    $ oc get pods -n virtual-builders

    출력 예

    NAME                                               READY   STATUS    RESTARTS   AGE
    f192fe4a-c802-4275-bcce-d2031e635126-9l2b5-25lg2   1/1     Running   0          7s

    $ oc get pods -n virtual-builders

    출력 예

    NAME                                               READY   STATUS        RESTARTS   AGE
    f192fe4a-c802-4275-bcce-d2031e635126-9l2b5-25lg2   1/1     Terminating   0          9s

    $ oc get pods -n virtual-builders

    출력 예

    No resources found in virtual-builders namespace.

14. 빌드가 완료되면 탐색 창에서 태그 아래에 있는 태그의 상태를 확인할 수 있습니다.

    참고

    초기 액세스 권한을 사용하면 현재 전체 빌드 로그 및 빌드 타임 스탬프를 사용할 수 없습니다.

절차

1. s3.console.aws.com 에서 AWS 콘솔에 로그인합니다.
2. 검색 창에서 S3 을 검색한 다음 S3 을 클릭합니다.
3. 버킷 이름을 클릭합니다(예: myawsbucket ).
4. 권한 탭을 클릭합니다.

5. CORS(Cross-origin resource sharing) 아래에서 다음 매개변수를 포함합니다.

     [
         {
             "AllowedHeaders": [
                 "Authorization"
             ],
             "AllowedMethods": [
                 "GET"
             ],
             "AllowedOrigins": [
                 "*"
             ],
             "ExposeHeaders": [],
             "MaxAgeSeconds": 3000
         },
         {
             "AllowedHeaders": [
                 "Content-Type",
                 "x-amz-acl",
                 "origin"
             ],
             "AllowedMethods": [
                 "PUT"
             ],
             "AllowedOrigins": [
                 "*"
             ],
             "ExposeHeaders": [],
             "MaxAgeSeconds": 3000
         }
     ]