3장. Build [build.openshift.io/v1]

completionDeadlineSeconds

integer

completionDeadlineSeconds는 시스템에서 빌드 Pod가 예약되는 시점부터 계산되는 선택적 기간(초)입니다. 시스템이 빌드를 적극적으로 종료하려고 시도하기 전에 빌드가 노드에서 활성화될 수 있습니다. 값은 양의 정수여야 합니다.

mountTrustedCA

boolean

mountTrustedCA 바인딩은 클러스터의 프록시 구성에 정의된 대로 클러스터의 신뢰할 수 있는 인증 기관을 빌드에 마운트합니다. 이를 통해 개인 아티팩트 리포지토리 및 HTTPS 프록시와 같은 사용자 정의 PKI 인증 기관에서 서명한 빌드 신뢰 구성 요소 내의 프로세스를 수행할 수 있습니다.

이 필드가 true로 설정되면 빌드 내의 /etc/pki/ca-trust 의 콘텐츠가 빌드 컨테이너에 의해 관리되고 이 디렉터리 또는 해당 하위 디렉터리(예: Dockerfile RUN 명령 내)에 대한 변경 사항은 빌드의 출력 이미지에 유지되지 않습니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 빌드 Pod가 노드에 적합한 경우 클러스터의 기본 빌드 노드 선택기 값으로 재정의할 수 있는 선택기입니다. 빈 맵 또는 값이 있는 맵으로 설정하면 기본 빌드 노드 선택기 값이 무시됩니다.

출력

object

BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.

postCommit

object

BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.

후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.

후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 rake test --verbose 를 실행합니다.

1. 쉘 스크립트:

"postCommit": { "script": "rake test --verbose", }

위의 형식은 다음과 같은 편리한 형식입니다.

"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }

2. 이미지 진입점으로서의 명령:

"postCommit": { "commit": ["rake", "test", "--verbose"] }

명령은 Docker: https://docs.docker.com/engine/reference/builder/#entrypoint 에 설명된 대로 exec 형식의 이미지 진입점을 재정의합니다.

3. 기본 진입점에 인수를 전달합니다.

"postCommit": { "args": ["rake", "test", "--verbose"] }

이 형식은 이미지 진입점에서 인수를 처리할 수 있는 경우에만 유용합니다.

4. 인수가 있는 쉘 스크립트:

"postCommit": { "script": "rake test $1", "args": ["--verbose"] }

이 양식은 쉘 스크립트에서 올바르게 인용하기 어려울 인수를 전달해야 하는 경우에 유용합니다. 스크립트에서 "/bin/sh"와 $ 1, 2 등은 Args의 위치 인수입니다.

5. 인수가 있는 명령:

"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }

이 양식은 Command 슬라이스에 인수를 추가하는 것과 동일합니다.

스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.

resources

resourceRequirements

리소스는 빌드를 실행하기 위해 리소스 요구 사항을 계산합니다.

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

serviceAccount

string

ServiceAccount는 이 빌드에서 생성한 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. Pod는 ServiceAccount에서 참조하는 시크릿을 사용할 수 있습니다.

소스

object

BuildSource는 빌드에 사용되는 SCM입니다.

전략

object

BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.

triggeredBy

array

TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.

triggeredBy[]

object

BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.

imageLabels

array

imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.

imageLabels[]

object

ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.

pushSecret

LocalObjectReference

pushSecret은 사용 가능한 인증 Docker Registry(또는 Docker Hub)에 대한 Docker 푸시를 실행하는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

다음으로 변경

ObjectReference

이 빌드의 출력을 내보낼 선택적 위치를 정의하려면 다음을 수행합니다. kind는 'ImageStreamTag' 또는 'DockerImage' 중 하나여야 합니다. 이 값은 내보낼 컨테이너 이미지 리포지토리를 찾는 데 사용됩니다. ImageStreamTag의 경우 Namespace를 지정하지 않는 한 ImageStreamTag는 빌드의 네임스페이스에서 검색됩니다.

name

string

name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다.

value

string

value는 레이블의 리터럴 값을 정의합니다.

args

배열(문자열)

인수는 Command, Script 또는 컨테이너 이미지의 기본 진입점에 제공되는 인수 목록입니다. 인수는 명령을 실행한 직후에 배치됩니다.

command

배열(문자열)

명령은 실행할 명령입니다. 스크립트로 지정할 수 없습니다. 이미지에 /bin/sh 가 없거나 쉘을 사용하지 않는 경우 이 작업이 필요할 수 있습니다. 다른 모든 경우에는 스크립트를 사용하는 것이 더 편리할 수 있습니다.

script

string

script는 /bin/sh -ic 를 사용하여 실행할 쉘 스크립트입니다. command를 사용하여 지정할 수 없습니다. 스크립트를 사용하여 스크립트를 사용하여 빌드 후 후크를 실행합니다(예: rake test 로 단위 테스트를 실행하는 경우). 이미지 진입점을 제어해야 하거나 이미지에 /bin/sh 가 없는 경우 명령 및/또는 Args를 사용합니다. 쉘에 적절한 컬렉션을 활성화하려면 -i 플래그는 소프트웨어 컬렉션(SCL)을 사용하는 CentOS 및 RHEL 이미지를 지원하는 데 필요합니다. 예를 들어 Ruby 이미지에서 이 값은 PATH에서 ruby,bundle 및 기타 바이너리를 사용할 수 있도록 하는 데 필요합니다.

Git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

바이너리

object

BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.

configMaps

array

ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.

configMaps[]

object

ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

contextDir

string

contextDir은 애플리케이션의 소스 코드가 있는 하위 디렉터리를 지정합니다. 그러면 리포지토리의 root가 아닌 다른 디렉터리에 빌드 가능한 소스가 있을 수 있습니다.

dockerfile

string

Dockerfile은 빌드해야 하는 Dockerfile의 원시 콘텐츠입니다. 이 옵션을 지정하면 전략 기본 이미지를 기반으로 FROM을 수정하고 전략 환경의 추가 ENV 스탠자가 FROM 뒤에 추가되지만 나머지 Dockerfile 스탠자 전에 추가됩니다. Dockerfile 소스 유형은 git과 같은 다른 옵션과 함께 사용할 수 있습니다. 이 경우 Git 리포지터리에 컨텍스트 dir에서 대체된 모든 Dockerfile이 있습니다.

Git

object

GitBuildSource는 Git SCM의 매개변수를 정의합니다.

이미지

array

이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.

images[]

object

ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).

secrets

array

보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.

secrets[]

object

SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

sourceSecret

LocalObjectReference

sourceSecret은 프라이빗 리포지토리 복제를 위한 인증을 설정하는 데 사용되는 보안의 이름입니다. 보안에는 원격 리포지토리에 대한 유효한 인증 정보가 포함되어 있습니다. 여기서 데이터의 키는 사용할 인증 방법을 나타내며 value는 base64로 인코딩된 인증 정보입니다. 지원되는 인증 방법은 ssh-privatekey입니다.

type

string

허용할 빌드 입력 유형

asFile

string

Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 /webapp.war 로 배치됩니다. 비어 있는 경우 Docker 및 Source 빌드 전략에서는 이 파일이 zip, tar 또는 tar.gz 파일이라고 가정하고 소스로 추출합니다. 사용자 지정 전략은 이 바이너리를 표준 입력으로 수신합니다. 이 파일 이름은 슬래시를 포함하거나 '..' 또는 '.'일 수 없습니다.

configMap

LocalObjectReference

ConfigMap은 빌드에서 사용하려는 기존 구성 맵에 대한 참조입니다.

destinationDir

string

destinationDir은 configmap의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

httpProxy

string

httpProxy는 http를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

httpsProxy

string

httpsProxy는 https를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 도메인 목록입니다.

ref

string

ref는 빌드할 분기/태그/참조입니다.

URI

string

URI는 빌드될 소스를 가리킵니다. 소스 구조는 실행할 빌드 유형에 따라 달라집니다.

as

배열(문자열)

다중 단계 컨테이너 이미지 빌드 중에 이 소스를 사용할 이미지 이름 목록입니다. 예를 들어 "COPY --from=nginx:latest"를 사용하는 Dockerfile은 먼저 이 필드에 "nginx:latest"가 있는 이미지 소스를 직접 가져오기 전에 확인합니다. Dockerfile에서 이미지 소스를 참조하지 않으면 무시됩니다. 이 필드와 경로는 모두 설정될 수 있으며, 이 경우 콘텐츠가 두 번 사용됩니다.

from

ObjectReference

에서 소스를 복사할 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 참조입니다.

경로

array

경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.

paths[]

object

ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.

pullSecret

LocalObjectReference

pullSecret은 레지스트리에서 이미지를 가져오는 데 사용할 보안에 대한 참조로, OpenShift 레지스트리에서 이미지를 가져오는 경우 이 필드를 설정할 필요가 없습니다.

destinationDir

string

destinationDir은 이미지에서 복사한 파일이 배치되는 빌드 디렉터리 내의 상대 디렉터리입니다.

sourcePath

string

SourcePath는 빌드 디렉터리에 복사할 이미지 내부의 파일 또는 디렉터리의 절대 경로입니다. 소스 경로가 /.로 종료되면 디렉터리의 콘텐츠가 복사되지만 디렉터리 자체는 대상에 생성되지 않습니다.

destinationDir

string

destinationDir은 시크릿의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 나중에 스크립트가 완료되면 삽입된 모든 파일이 0 길이로 잘립니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

Secret

LocalObjectReference

Secret은 빌드에서 사용하려는 기존 보안에 대한 참조입니다.

customStrategy

object

CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.

dockerStrategy

object

DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.

jenkinsPipelineStrategy

object

JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용

sourceStrategy

object

SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.

type

string

유형은 빌드 전략의 종류입니다.

buildAPIVersion

string

buildAPIVersion은 Build 오브젝트 직렬화 및 사용자 정의 빌더에 대해 요청된 API 버전입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

exposeDockerSocket

boolean

exposeDockerSocket을 사용하면 컨테이너 내부에서 Docker 명령(및 컨테이너 이미지 빌드)을 실행할 수 있습니다.

forcePull

boolean

forcePull은 컨트롤러가 항상 빌더의 이미지를 가져오도록 빌드 Pod를 구성해야 하는지 또는 로컬에 없는 경우에만 가져오기를 수행해야 하는지 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

secrets

array

보안은 빌드 Pod에 포함될 추가 보안 목록입니다.

secrets[]

object

SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.

mountPath

string

mountPath는 시크릿을 마운트할 경로입니다.

secretSource

LocalObjectReference

secretSource는 보안에 대한 참조입니다.

buildArgs

array(EnvVar)

buildArgs에는 Dockerfile에서 해결할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 을 참조하십시오. 참고: 'name' 및 '값' 필드만 지원됩니다. 'valueFrom' 필드의 설정은 모두 무시됩니다.

dockerfilePath

string

dockerfilePath는 컨텍스트 루트(contextDir)를 기준으로 컨테이너 이미지를 빌드하는 데 사용할 Dockerfile의 경로입니다. 설정되지 않은 경우 기본값은 Dockerfile 입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 빌드의 Dockerfile의 FROM 이미지를 재정의하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. Dockerfile에서 다중 단계 빌드를 사용하는 경우 파일의 마지막 FROM 지시문에 있는 이미지를 대체합니다.

imageOptimizationPolicy

string

imageOptimizationPolicy는 이미지 빌드에 소요되는 최종 크기 또는 시간을 줄이기 위해 이미지를 빌드할 때 사용할 수 있는 최적화를 설명합니다. 기본 정책은 '없음'으로, 최종 빌드 이미지가 컨테이너 이미지 빌드 API에서 생성한 이미지와 동일합니다. 실험적 정책 'SkipLayers'는 각 이미지 단계 사이에 새 계층을 커밋하지 않으며 Dockerfile에서 '없음' 정책과의 호환성을 제공할 수 없는 경우 실패합니다. 추가 실험 정책 'SkipLayersAndWarn'은 'SkipLayers'와 동일하지만 호환성을 유지할 수 없는 경우 경고합니다.

noCache

boolean

noCache true로 설정하면 --no-cache=true 플래그를 사용하여 컨테이너 이미지 빌드를 실행해야 함을 나타냅니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

env

array(EnvVar)

env에는 빌드 파이프라인에 전달할 추가 환경 변수가 포함되어 있습니다.

jenkinsfile

string

Jenkinsfile은 Jenkins 파이프라인 빌드를 정의하는 Jenkinsfile의 선택적 원시 콘텐츠를 정의합니다.

jenkinsfilePath

string

jenkinsfilePath는 컨텍스트 루트(contextDir)를 기준으로 파이프라인을 구성하는 데 사용할 Jenkinsfile의 선택적 경로입니다. JenkinsfilePath 및 Jenkinsfile 둘 다 지정되지 않은 경우 기본값은 지정된 contextDir의 루트에서 Jenkinsfile으로 설정됩니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

증분

boolean

증분 플래그는 true인 경우 소스 빌드가 증분 빌드를 수행하도록 강제 적용합니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

스크립트

string

스크립트는 소스 스크립트의 위치입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

bitbucketWebHook

object

BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.

genericWebHook

object

GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.

githubWebHook

object

GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.

gitlabWebHook

object

GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.

imageChangeBuild

object

ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.

message

string

message는 빌드가 트리거된 이유에 대한 사람이 읽을 수 있는 메시지를 저장하는 데 사용됩니다. 예: "Manually triggered by user", "Configuration change",etc.

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

Git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

Git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

Git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

Git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

fromRef

ObjectReference

fromRef에는 빌드를 트리거한 이미지에 대한 자세한 정보가 포함되어 있습니다.

imageID

string

ImageId는 새 빌드를 트리거한 이미지의 ID입니다.

취소됨

boolean

취소된 이벤트는 빌드에 대해 취소 이벤트가 트리거되었는지 여부를 나타냅니다.

completionTimestamp

시간

completionTimestamp는 빌드 실패 또는 성공 여부에 관계없이 이 빌드가 완료된 서버 시간을 나타내는 타임스탬프입니다. 빌드를 실행하는 Pod가 종료된 시간을 반영합니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

conditions

array

조건은 빌드의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

BuildCondition은 특정 시점에서 빌드 상태를 설명합니다.

config

ObjectReference

config는 이 Build가 기반으로 하는 BuildConfig에 대한 ObjectReference입니다.

duration

integer

duration에는 빌드 시간을 설명하는 time.Duration 오브젝트가 포함됩니다.

logSnippet

string

logSnippet은 빌드 로그의 마지막 몇 줄입니다. 이 값은 실패한 빌드에만 설정됩니다.

message

string

message는 빌드의 상태가 이 상태에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

출력

object

BuildStatusOutput에는 빌드된 이미지의 상태가 포함됩니다.

outputDockerImageReference

string

outputDockerImageReference에는 이 빌드에서 빌드할 컨테이너 이미지에 대한 참조가 포함되어 있습니다. 해당 값은 Build.Spec.Output.To에서 계산되며 이미지를 푸시하고 가져오는 데 사용할 수 있도록 레지스트리 주소를 포함해야 합니다.

phase

string

단계는 빌드 라이프사이클의 지점입니다. 가능한 값은 "New", "Pending", "Running", "Complete", "Failed", "Error", "Cancelled"입니다.

reason

string

이유는 오류를 설명하는 짧은 CamelCase 문자열이며 CLI에서 머신 구문 분석 및 tidy 표시를 의미합니다.

단계

array

스테이지에는 시작 시간, 기간(밀리초) 및 각 단계 내에서 발생한 단계를 포함하여 빌드 중에 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.

stages[]

object

StageInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.

startTimestamp

시간

startTimestamp는 이 빌드가 Pod에서 실행되기 시작한 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

lastTransitionTime

시간

조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다.

lastUpdateTime

시간

이 조건이 마지막으로 업데이트된 시간입니다.

message

string

전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

조건의 상태, True, False, 알 수 없음.

type

string

빌드 조건 유형입니다.

다음으로 변경

object

BuildStatusOutputTo는 푸시해야 하는 이미지 레지스트리와 관련하여 빌드된 이미지의 상태를 설명합니다.

imageDigest

string

imageDigest는 빌드된 컨테이너 이미지의 다이제스트입니다. 다이제스트는 푸시된 레지스트리에서 이미지를 고유하게 식별합니다.

이 필드는 푸시가 성공적으로 완료된 경우에도 이 필드가 항상 설정되지 않을 수 있습니다. 예를 들어 레지스트리에서 다이제스트를 반환하지 않거나 빌더가 이해할 수 없는 형식으로 반환하는 경우입니다.

durationMilliseconds

integer

durationMilliseconds는 스테이지가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다. 참고: 스테이지 기간은 명시적 빌드 단계에서 모든 작업이 고려되는 것은 아니므로 스테이지 내의 단계 기간의 합계를 초과할 수 있습니다.

name

string

name은 수행되는 각 빌드 단계의 고유 식별자입니다.

startTime

시간

StartTime은 이 단계가 시작될 때 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

단계

array

단계에는 시작 시간 및 지속 시간(밀리초)을 포함하여 빌드 단계에서 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.

steps[]

object

StepInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.

durationMilliseconds

integer

durationMilliseconds는 단계가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다.

name

string

name은 각 빌드 단계의 고유 식별자입니다.

startTime

시간

StartTime은 이 단계가 시작될 때 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.