워크로드 API

completionDeadlineSeconds

integer

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

failedBuildsHistoryLimit

integer

failedBuildsHistoryLimit은 유지할 수 없는 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근 실패한 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 실패한 모든 빌드가 유지됩니다.

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은 빌드 소스의 버전 또는 커밋 정보입니다.

runPolicy

string

runPolicy는 이 빌드 구성에서 생성된 새 빌드가 실행을 위해 예약되는 방법을 설명합니다. 지정하지 않으면 선택 사항입니다. 기본값은 "Serial"입니다.

serviceAccount

string

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

소스

object

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

전략

object

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

successfulBuildsHistoryLimit

integer

successfulBuildsHistoryLimit은 유지할 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근의 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 모든 성공적인 빌드가 유지됩니다.

triggers

array

트리거는 BuildConfig에서 새 빌드를 시작하는 방법을 결정합니다. 트리거가 정의되지 않은 경우 명시적 클라이언트 빌드 생성으로 인해 새 빌드가 발생할 수 있습니다.

triggers[]

object

BuildTriggerPolicy는 새 Build를 생성하는 단일 트리거에 대한 정책을 설명합니다.

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의 매개변수를 정의합니다.

images

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

bitbucket

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

일반

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

github

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

gitlab

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

imageChange

object

ImageChangeTrigger를 사용하면 ImageStream이 변경될 때 빌드를 트리거할 수 있습니다.

type

string

type은 빌드 트리거의 유형입니다. 유효한 값은 다음과 같습니다.

- GitHubWebHookBuildTriggerType은 GitHub Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- 일반 GenericWebHookBuildType은 일반 웹 후크 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- GitLab GitLabWebHookBuildTriggerType은 GitLab Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- Bitbucket BitbucketWebHookBuildTriggerType은 Bitbucket Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- ImageChange ImageChangeBuildTriggerType은 새 버전의 이미지 사용 가능 여부에 따라 빌드를 시작하는 트리거를 나타냅니다.

- ConfigChange ConfigChangeBuildTriggerType은 초기 빌드 구성 생성 경고에 대한 빌드를 트리거합니다. 나중에 구성 변경 시 빌드를 트리거하도록 동작이 변경됩니다.

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

from

ObjectReference

에서 은 업데이트될 때 빌드를 트리거하는 ImageStreamTag에 대한 참조입니다. From이 지정되지 않으면 빌드 전략의 From 이미지가 사용됩니다. 빈 From 참조가 있는 ImageChangeTrigger 하나만 빌드 구성에서 허용됩니다.

lastTriggeredImageID

string

lastTriggeredImageID는 ImageChangeController에서 내부적으로 사용하여 빌드에 마지막으로 사용된 이미지 ID를 저장합니다. 이 필드는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 더 이상 사용되지 않음

일시 중지됨

boolean

이 트리거를 일시적으로 비활성화하면 paused가 적용됩니다. 선택 사항입니다.

imageChangeTriggers

array

imageChangeTriggers는 lastTriggeredImageID에 대한 OpenShift APIServer에서 조정하는 값을 포함하여 BuildConfigSpec에 지정된 ImageChangeTrigger의 런타임 상태를 캡처합니다. spec의 각 이미지 변경 트리거에 대해 이 배열에 단일 항목이 있습니다. 각 트리거 상태는 트리거의 소스 역할을 하는 ImageStreamTag를 참조합니다.

imageChangeTriggers[]

object

ImageChangeTriggerStatus는 BuildConfigSpec.Triggers 구조에 지정된 관련 ImageChangeTrigger 정책의 최신 확인된 상태를 추적합니다.

lastVersion

integer

lastVersion은 마지막 트리거된 빌드 수를 알리는 데 사용됩니다.

from

object

ImageStreamTagReference는 네임스페이스 및 이름으로 이미지 변경 트리거의 ImageStreamTag를 참조합니다.

lastTriggerTime

시간

lastTriggerTime은 이 특정 ImageStreamTag가 빌드가 시작되는 마지막 시간입니다. 이 필드는 이 트리거가 특별히 Build를 시작한 경우에만 업데이트됩니다.

lastTriggeredImageID

string

lastTriggeredImageID는 이 BuildConfig의 Build가 시작될 때 ImageStreamTag의 sha/id를 나타냅니다. 이 ImageStreamTag가 Build가 시작된 이유가 아니더라도 lastTriggeredImageID가 이 BuildConfig에 대한 Build가 시작될 때마다 업데이트됩니다.

name

string

name은 ImageChangeTrigger에 대한 ImageStreamTag의 이름입니다.

네임스페이스

string

namespace는 ImageChangeTrigger의 ImageStreamTag가 있는 네임스페이스입니다.

200 - OK

BuildConfigList schema

401 - 무단

빈

200 - OK

WatchEvent 스키마

401 - 무단

빈

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

200 - OK

상태 스키마

401 - 무단

빈

200 - OK

BuildConfigList schema

401 - 무단

빈

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

body

BuildConfig schema

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

202 - 승인됨

BuildConfig schema

401 - 무단

빈

200 - OK

WatchEvent 스키마

401 - 무단

빈

name

string

BuildConfig 이름

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

빈

200 - OK

BuildConfig schema

401 - 무단

빈

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

401 - 무단

빈

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - All: 모든 시험 실행 단계가 처리됩니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

body

BuildConfig schema

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

401 - 무단

빈

name

string

BuildConfig 이름

200 - OK

WatchEvent 스키마

401 - 무단

빈

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