3장. 애플리케이션 생성

프로세스

• 다음 명령을 실행하여 템플릿에 라벨을 추가합니다.

  $ oc process -f <filename> -l name=otherLabel

프로세스

• 다음 명령을 실행하여 로컬 템플릿 파일에서 템플릿 매개변수를 나열합니다.

  $ oc process --parameters -f <filename>

• 다음 명령을 실행하여 업로드된 템플릿의 템플릿 매개변수를 나열합니다.

  $ oc process --parameters -n <project> <template_name>

  예를 들어 기본 openshift 프로젝트에서 rails-postgresql-example 퀵 스타트 템플릿의 매개변수를 나열하려면 다음 명령을 실행합니다.

  $ oc process --parameters -n openshift rails-postgresql-example

  출력 예

  NAME                         DESCRIPTION                                                                                              GENERATOR           VALUE
  SOURCE_REPOSITORY_URL        The URL of the repository with your application source code                                                                  https://github.com/sclorg/rails-ex.git
  SOURCE_REPOSITORY_REF        Set this to a branch name, tag or other ref of your repository if you are not using the default branch
  CONTEXT_DIR                  Set this to the relative path to your project if it is not in the root of your repository
  APPLICATION_DOMAIN           The exposed hostname that will route to the Rails service                                                                    rails-postgresql-example.openshiftapps.com
  GITHUB_WEBHOOK_SECRET        A secret string used to configure the GitHub webhook                                                     expression          [a-zA-Z0-9]{40}
  SECRET_KEY_BASE              Your secret key for verifying the integrity of signed cookies                                            expression          [a-z0-9]{127}
  APPLICATION_USER             The application user that is used within the sample application to authorize access on pages                                 openshift
  APPLICATION_PASSWORD         The application password that is used within the sample application to authorize access on pages                             secret
  DATABASE_SERVICE_NAME        Database service name                                                                                                        postgresql
  POSTGRESQL_USER              database username                                                                                        expression          user[A-Z0-9]{3}
  POSTGRESQL_PASSWORD          database password                                                                                        expression          [a-zA-Z0-9]{8}
  POSTGRESQL_DATABASE          database name                                                                                                                root
  POSTGRESQL_MAX_CONNECTIONS   database max connections                                                                                                     10
  POSTGRESQL_SHARED_BUFFERS    database shared buffers                                                                                                      12MB

  출력에서는 템플릿이 처리될 때 생성기와 같이 정규식으로 생성되는 여러 매개변수를 식별합니다.

프로세스

• 템플릿 정의 파일을 처리하여 오브젝트 목록을 표준 출력으로 반환할 수 있습니다.

  $ oc process -f <filename>

• 다음 명령을 실행하여 현재 프로젝트에서 업로드된 템플릿을 처리하여 오브젝트 목록을 표준 출력으로 반환합니다.

  $ oc process <template_name>

• 템플릿을 처리하고 출력을 oc create로 파이핑하여 다음 명령을 실행하여 oc create에서 오브젝트를 생성합니다.

  $ oc process -f <filename> | oc create -f -

• 템플릿을 처리하고 다음 명령을 실행하여 출력을 oc create로 파이핑하여 현재 프로젝트에서 업로드된 템플릿에서 오브젝트를 생성합니다.

  $ oc process <template> | oc create -f -

• 재정의하려는 각 <name>=<value> 쌍에 -p 옵션을 추가하여 파일에 정의된 매개변수 값을 재정의할 수 있습니다. 매개변수 참조는 템플릿 항목 내의 텍스트 필드에 표시될 수 있습니다.

  예를 들어 다음에서는 템플릿의 POSTGRESQL_USER 및 POSTGRESQL_DATABASE 매개변수가 재정의되어 사용자 정의된 환경 변수가 있는 구성을 출력합니다.

  • 다음 명령을 실행하여 템플릿에서 오브젝트 목록을 생성합니다.

    $ oc process -f my-rails-postgresql \
        -p POSTGRESQL_USER=bob \
        -p POSTGRESQL_DATABASE=mydatabase

  • 다음 명령을 실행하여 처리된 출력에서 오브젝트를 생성합니다.

    $ oc process -f my-rails-postgresql \
        -p POSTGRESQL_USER=bob \
        -p POSTGRESQL_DATABASE=mydatabase \
        | oc create -f -

    참고

    JSON 출력을 파일로 리디렉션하거나 oc create 명령으로 템플릿을 파이핑하여 템플릿을 업로드하지 않고 직접 적용할 수 있습니다.

  • 많은 수의 매개변수가 있는 경우 파일에 저장한 후 해당 파일을 oc process로 전달할 수 있습니다.

    $ cat postgres.env

    $ oc process -f my-rails-postgresql --param-file=postgres.env

    출력 예

    POSTGRESQL_USER=bob
    POSTGRESQL_DATABASE=mydatabase

  • 다음 명령을 실행하여 "-"를 --param-file 옵션 값으로 지정하여 표준 입력에서 매개변수 값을 읽을 수도 있습니다.

    $ sed s/bob/alice/ postgres.env | oc process -f my-rails-postgresql --param-file=-

• 템플릿에 있는 임의의 문자열 필드에 ${PARAMETER_NAME} 형식의 값을 배치하여 문자열 값으로 참조합니다.
• 템플릿에서 임의의 필드 대신 ${{PARAMETER_NAME}} 형식의 값을 배치하여 JSON 또는 YAML 값으로 참조합니다.

• [\w]{10} 은 10개의 영문자, 숫자 및 밑줄을 생성합니다. 이는 PCRE 표준을 따르며 [a-zA-Z0-9_]{10} 과 동일합니다.
• [\D]{10} 은 10개의 숫자를 생성합니다. [0-9]{10} 과 동일합니다.
• [\a]{10} 은 10개의 알파벳 문자를 생성합니다. [a-zA-Z]{10} 과 동일합니다.
• [\a]{10} 은 10개의 구두점 또는 기호 문자를 생성합니다. 이는 [~!@#$%\^&*()\-_+={}\[\]\\|<,>.?/"';:`]{10}과 동일합니다.

프로세스

• 일반 사용자가 지정된 템플릿에서 template.openshift.io/bindable: "false" 주석을 바인딩하지 않도록 합니다.

프로세스

• template.openshift.io/expose- 주석을 사용하여 필드 값을 문자열로 반환합니다. 이 방법에서는 임의의 바이너리 데이터를 처리하지 않습니다.
• 바이너리 데이터를 반환하려면 template.openshift.io/base64-expose- 주석을 사용하여 데이터를 반환하기 전에 base64로 인코딩합니다.

• 메모리, CPU 및 스토리지 기본 크기를 설정하여 애플리케이션에 원활한 실행을 충분히 제공되도록 합니다.
• latest 태그가 주요 버전 간에 사용되는 경우 이미지의 해당 태그를 참조하지 마십시오. 새 이미지를 해당 태그로 푸시하면 실행 중인 애플리케이션이 중단될 수도 있습니다.
• 좋은 템플릿은 템플릿 배포 후 수정할 필요 없이 깔끔하게 빌드되고 배포됩니다.

프로세스

• 템플릿 기능을 사용하려면 템플릿에서 Build,BuildConfig,Deployment,DeploymentConfig,Job 또는 StatefulSet 유형의 하나 이상의 오브젝트를 다음 주석으로 표시하십시오.

  "template.alpha.openshift.io/wait-for-ready": "true"

  주석이 표시된 모든 오브젝트가 준비되었다고 보고할 때까지 템플릿에서 리소스를 생성하는 작업이 완료되지 않습니다. 마찬가지로 주석이 있는 오브젝트 보고서 중 실패하는 보고서가 있거나 템플릿이 1시간이라는 고정된 제한 시간 내에 준비되지 않으면 템플릿에서 리소스를 생성하지 못합니다.

  템플릿에서 리소스를 생성할 때 각 오브젝트 종류의 준비 및 실패는 다음과 같이 정의됩니다.

  유형	준비	실패
  Build	오브젝트가 완료 단계 보고	오브젝트가 취소, 오류 또는 실패 단계 보고
  BuildConfig	관련된 최신 빌드 오브젝트가 완료 단계 보고	관련된 최신 빌드 오브젝트가 취소, 오류 또는 실패 단계 보고
  Deployment	오브젝트는 사용 가능한 새 복제본 세트 및 배포를 보고합니다. 이 명령은 오브젝트에 정의된 준비 상태 프로브를 따릅니다.	오브젝트가 진행 상태를 False로 보고
  DeploymentConfig	오브젝트가 사용 가능한 새 복제 컨트롤러 및 배포를 보고합니다. 이 명령은 오브젝트에 정의된 준비 상태 프로브를 따릅니다.	오브젝트가 진행 상태를 False로 보고
  작업	오브젝트가 완료 보고	오브젝트가 하나 이상의 실패가 발생했음을 보고
  StatefulSet	오브젝트가 준비된 모든 복제본을 보고합니다. 이 명령은 오브젝트에 정의된 준비 상태 프로브를 따릅니다.	해당 없음

  다음은 wait-for-ready 주석을 사용하는 템플릿 추출의 예입니다. 더 많은 예는 OpenShift Container Platform 퀵 스타트 템플릿에서 찾을 수 있습니다.

  kind: Template
  apiVersion: template.openshift.io/v1
  metadata:
    name: my-template
  objects:
  - kind: BuildConfig
    apiVersion: build.openshift.io/v1
    metadata:
      name: ...
      annotations:
        # wait-for-ready used on BuildConfig ensures that creating resources from the template
        # fails immediately if the build fails
        template.alpha.openshift.io/wait-for-ready: "true"
    spec:
      ...
  - kind: DeploymentConfig
    apiVersion: apps.openshift.io/v1
    metadata:
      name: ...
      annotations:
        template.alpha.openshift.io/wait-for-ready: "true"
    spec:
      ...
  - kind: Service
    apiVersion: v1
    metadata:
      name: ...
    spec:
      ...

프로세스

• 다음 명령을 실행하여 프로젝트의 오브젝트를 내보냅니다.

  $ oc get -o yaml all > <yaml_filename>

  all을 사용하지 않고 특정 리소스 유형 또는 여러 리소스를 대체할 수도 있습니다. 더 많은 예를 보려면 oc get -h를 실행하십시오.

  oc get -o yaml all에 포함된 오브젝트 유형은 다음과 같습니다.

  • BuildConfig
  • Build
  • DeploymentConfig
  • ImageStream
  • Pod
  • ReplicationController
  • 경로

  • Service

    참고

    all 별칭을 사용하는 것은 다른 클러스터 및 버전마다 내용이 다를 수 있으므로 권장되지 않습니다. 대신 필요한 모든 리소스를 지정합니다.