3장. 애플리케이션 생성


3.1. 템플릿 사용

템플릿을 사용하여 사전 구성된 애플리케이션을 배포하고 OpenShift Container Platform 클러스터에 재사용 가능한 오브젝트 정의를 생성할 수 있습니다. 웹 콘솔 또는 CLI에서 템플릿을 업로드, 인스턴스화 및 작성하여 애플리케이션 생성 속도를 향상시킵니다.

3.1.1. 템플릿 이해

템플릿을 사용하여 OpenShift Container Platform에서 처리하는 재사용 가능하고 매개변수화된 오브젝트 세트를 Service 및 DeploymentConfig 오브젝트와 같은 리소스로 설명할 수 있습니다. 템플릿을 사용하면 웹 콘솔 또는 CLI에서 동일한 애플리케이션 구조를 일관되게 배포할 수 있습니다.

프로젝트 내에서 생성할 수 있는 권한이 있는 모든 항목을 생성하도록 템플릿을 처리할 수 있습니다. 템플릿은 템플릿에 정의된 모든 오브젝트에 적용할 레이블 세트를 정의할 수도 있습니다.

3.1.2. 템플릿 업로드

OpenShift Container Platform 프로젝트에 템플릿을 추가하려면 CLI를 사용하여 JSON 또는 YAML 템플릿 파일을 업로드합니다. 업로드된 템플릿은 해당 프로젝트에 액세스할 수 있는 사용자가 재사용할 수 있도록 프로젝트 템플릿 라이브러리에 저장됩니다.

절차

  • 다음 방법 중 하나를 사용하여 템플릿을 업로드합니다.

    • 다음 명령을 실행하여 현재 프로젝트의 템플릿 라이브러리에 JSON 또는 YAML 템플릿 파일을 업로드합니다.

      $ oc create -f <filename>
    • 다음 명령을 실행하여 프로젝트 이름과 함께 -n 옵션을 사용하여 템플릿을 다른 프로젝트에 업로드합니다.

      $ oc create -f <filename> -n <project>

      이제 웹 콘솔 또는 CLI를 사용하여 템플릿을 선택할 수 있습니다.

3.1.3. 웹 콘솔을 사용하여 애플리케이션 생성

OpenShift Container Platform 클러스터의 템플릿에서 애플리케이션을 생성하려면 웹 콘솔 개발자 카탈로그 를 사용합니다. 템플릿 또는 빌더 이미지를 선택하고 배포 전에 생성된 오브젝트를 구성합니다.

절차

  1. 프로젝트로 이동하여 +추가 를 클릭합니다.
  2. 개발자 카탈로그 타일에서 모든 서비스를 클릭합니다.
  3. 유형에서 빌더 이미지를 클릭하여 사용 가능한 빌더 이미지를 확인합니다.

    참고

    다음 예와 같이 주석에 builder 태그가 나열된 이미지 스트림 태그만 이 목록에 표시됩니다. 이미지 스트림 태그가 웹 콘솔에 빌더 로 표시되도록 태그 주석에 빌더를 포함합니다.

    kind: "ImageStream"
    apiVersion: "image.openshift.io/v1"
    metadata:
      name: "ruby"
      creationTimestamp: null
    spec:
    # ...
      tags:
        - name: "2.6"
          annotations:
            description: "Build and run Ruby 2.6 applications"
            iconClass: "icon-ruby"
            tags: "builder,ruby"
            supports: "ruby:2.6,ruby"
            version: "2.6"
    # ...
  4. 새 애플리케이션 화면에서 설정을 수정하여 애플리케이션을 지원하도록 오브젝트를 구성합니다.

3.1.4. CLI를 사용하여 템플릿에서 오브젝트 생성

CLI를 사용하여 템플릿을 프로젝트의 오브젝트 목록으로 처리하여 OpenShift Container Platform 클러스터의 템플릿에서 오브젝트를 생성할 수 있습니다. CLI 명령을 사용하여 템플릿 레이블, 매개변수 및 생성된 오브젝트 목록을 관리합니다.

3.1.4.1. 레이블 추가

OpenShift Container Platform 클러스터에서 템플릿을 처리할 때 라벨을 추가하려면 라벨 선택기를 oc process 명령에 전달합니다. 템플릿에 지정된 레이블은 템플릿에서 생성된 모든 오브젝트에 적용됩니다.

레이블은 pod 같은 생성된 오브젝트를 관리하고 구성하는 데 사용됩니다.

절차

  • 다음 명령을 실행하여 템플릿에 레이블을 추가합니다.

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

3.1.4.2. 매개변수 나열

OpenShift Container Platform 클러스터에 템플릿 매개변수를 나열하여 템플릿을 처리하기 전에 덮어쓸 수 있는 값을 확인할 수 있습니다. oc process --parameters 명령을 템플릿 파일과 함께 사용하거나 업로드된 템플릿 이름을 사용합니다.

절차

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

    $ 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

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

3.1.4.3. 오브젝트 목록 생성

OpenShift Container Platform 클러스터에서 생성된 템플릿을 보려면 템플릿에서 해당 템플릿을 적용하지 않고 oc process 를 실행합니다. 프로젝트에서 리소스를 생성하기 전에 생성된 오브젝트 목록을 검토하고 파일에 저장합니다.

절차

  • 다음 명령을 실행하여 오브젝트 목록을 표준 출력으로 반환하도록 템플릿을 정의하는 파일을 처리합니다.

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

    $ oc process <template_name>
  • 다음 명령을 실행하여 템플릿을 처리하고 출력을 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=-

3.1.5. 업로드된 템플릿 수정

OpenShift Container Platform 프로젝트에 이미 저장된 템플릿을 업데이트하려면 템플릿 오브젝트를 편집하고 기존 버전을 교체합니다. 업데이트된 템플릿은 재사용을 위해 프로젝트 템플릿 라이브러리에서 계속 사용할 수 있습니다.

절차

  • 다음 명령을 실행하여 이미 업로드된 템플릿을 수정합니다.

    $ oc edit template <template>

3.1.6. 인스턴트 앱 및 빠른 시작 템플릿 사용

OpenShift Container Platform 클러스터의 인스턴트 앱 템플릿에서 샘플 애플리케이션을 시도하려면 템플릿에서 애플리케이션을 생성하고 필요한 경우 템플릿의 소스 리포지터리를 분기합니다. 빌드 구성을 사용자 지정하여 변경 사항을 테스트하고 애플리케이션을 다시 빌드합니다.

OpenShift Container Platform은 다양한 언어를 위한 새 애플리케이션을 빠르게 생성할 수 있도록 몇 가지 기본 즉시 앱 및 퀵 스타트 템플릿을 제공합니다. Rails(Ruby), Django(Python), Node.js, CakePHP(PHP) 및 Dancer(Perl)에 대한 템플릿이 제공됩니다. 클러스터 관리자가 기본 글로벌 openshift 프로젝트에서 이러한 템플릿을 생성한 경우 해당 템플릿에 액세스할 수 있습니다.

기본적으로 템플릿은 필요한 애플리케이션 코드가 포함된 GitHub의 공용 소스 리포지터리를 사용하여 빌드합니다.

절차

  1. 다음 명령을 실행하여 사용 가능한 기본 즉시 앱 및 퀵 스타트 템플릿을 나열합니다.

    $ oc get templates -n openshift
  2. 소스를 수정하여 자체 애플리케이션 버전을 빌드합니다.

    1. 템플릿의 기본 SOURCE_REPOSITORY_URL 매개변수에서 참조하는 리포지토리를 분기합니다.
    2. 템플릿에서 생성하는 경우 기본값 대신 포크를 지정하여 SOURCE_REPOSITORY_URL 매개변수 값을 재정의합니다.

      이렇게 하면 템플릿에서 생성한 빌드 구성이 이제 애플리케이션 코드의 포크를 가리킵니다. 그런 다음 코드를 수정하고 필요에 따라 애플리케이션을 다시 빌드할 수 있습니다.

      참고

      일부 인스턴트 앱 및 퀵 스타트 템플릿은 데이터베이스 DeploymentConfig 오브젝트를 정의합니다. 정의된 구성은 데이터베이스 컨텐츠에 ephemeral 스토리지를 사용합니다. 어떤 이유로든 데이터베이스 pod가 다시 시작되면 데이터베이스 데이터가 모두 손실되므로 이러한 템플릿은 설명용으로만 사용해야 합니다.

3.1.6.1. 퀵 스타트 템플릿

OpenShift Container Platform 클러스터에서 샘플 인스턴트 앱 및 퀵 스타트 템플릿을 찾으려면 openshift 프로젝트의 기본 템플릿을 검토하십시오. 이러한 템플릿을 사용하여 공통 언어 및 프레임워크에 대한 예제 애플리케이션을 배포합니다.

퀵 스타트 템플릿은 OpenShift Container Platform에서 실행되는 애플리케이션의 기본 예입니다. 퀵 스타트는 다양한 언어와 프레임워크로 제공되며 일련의 Service,BuildConfig, DeploymentConfig 오브젝트로 구성된 템플릿에 정의됩니다. 이 템플릿은 애플리케이션을 빌드하고 배포하는 데 필요한 이미지 및 소스 리포지터리를 참조합니다.

관리자가 이미 OpenShift Container Platform 클러스터에 이러한 템플릿을 설치해야 합니다. 이 경우 웹 콘솔에서 선택할 수 있습니다.

퀵 스타트는 애플리케이션 소스 코드가 포함된 소스 리포지터리를 나타냅니다. 퀵 스타트를 사용자 정의하려면 리포지터리를 포크하고 템플릿에서 애플리케이션을 생성할 때 기본 소스 리포지토리 이름을 분기된 리포지터리로 대체합니다. 그러면 제공된 소스 예 대신 소스 코드를 사용하여 수행되는 빌드가 생성됩니다. 그런 다음, 소스 리포지터리에서 코드를 업데이트하고 새 빌드를 시작하여 배포된 애플리케이션에 변경 사항이 반영된 것을 확인할 수 있습니다.

3.1.6.1.1. 웹 프레임워크 퀵 스타트 템플릿

이러한 퀵 스타트 템플릿은 표시된 프레임워크 및 언어의 기본 애플리케이션을 제공합니다.

  • CakePHP: PHP 웹 프레임워크(MySQL 데이터베이스 포함)
  • Dancer: Perl 웹 프레임워크(MySQL 데이터베이스 포함)
  • Django: Python 웹 프레임워크(PostgreSQL 데이터베이스 포함)
  • NodeJS: NodeJS 웹 애플리케이션(MongoDB 데이터베이스 포함)
  • Rails: Ruby 웹 프레임워크(PostgreSQL 데이터베이스 포함)

3.1.7. 템플릿 작성

OpenShift Container Platform 클러스터에 재사용 가능한 애플리케이션 템플릿을 정의하려면 배포 및 생성을 안내하는 리소스를 나열하는 템플릿 오브젝트를 생성합니다.

고유한 템플릿을 작성하기 전에 다음 샘플 YAML을 사용하여 구조를 검토합니다.

apiVersion: template.openshift.io/v1
kind: Template
metadata:
  name: redis-template
  annotations:
    description: "Description"
    iconClass: "icon-redis"
    tags: "database,nosql"
objects:
- apiVersion: v1
  kind: Pod
  metadata:
    name: redis-master
  spec:
    containers:
    - env:
      - name: REDIS_PASSWORD
        value: ${REDIS_PASSWORD}
      image: dockerfile/redis
      name: master
      ports:
      - containerPort: 6379
        protocol: TCP
parameters:
- description: Password used for Redis authentication
  from: '[A-Z0-9]{8}'
  generate: expression
  name: REDIS_PASSWORD
labels:
  redis: master

3.1.7.1. 템플릿 설명 작성

사용자가 웹 콘솔에서 템플릿을 찾고 이해할 수 있도록 하려면 표시 이름, 태그 및 아이콘 클래스와 같은 설명 메타데이터를 추가합니다. 이 참조의 주석을 사용하여 문서 용도, 경고, 링크를 지원합니다.

다음은 템플릿 설명 메타데이터의 예입니다.

kind: Template
apiVersion: template.openshift.io/v1
metadata:
  name: cakephp-mysql-example
  annotations:
    openshift.io/display-name: "CakePHP MySQL Example (Ephemeral)"
    description: >-
      An example CakePHP application with a MySQL database. For more information
      about using this template, including OpenShift considerations, see
      https://github.com/sclorg/cakephp-ex/blob/master/README.md.


      WARNING: Any data stored will be lost upon pod destruction. Only use this
      template for testing."
    openshift.io/long-description: >-
      This template defines resources needed to develop a CakePHP application,
      including a build configuration, application DeploymentConfig, and
      database DeploymentConfig.  The database is stored in
      non-persistent storage, so this configuration should be used for
      experimental purposes only.
    tags: "quickstart,php,cakephp"
    iconClass: icon-php
    openshift.io/provider-display-name: "Red Hat, Inc."
    openshift.io/documentation-url: "https://github.com/sclorg/cakephp-ex"
    openshift.io/support-url: "https://access.redhat.com"
message: "Your admin credentials are ${ADMIN_USERNAME}:${ADMIN_PASSWORD}"

다음과 같습니다.

metadata.name
템플릿의 고유 이름을 지정합니다.
metadata.annotations.openshift.io/display-name
사용자 인터페이스에서 사용할 수 있는 간단한 사용자 친화적인 이름을 지정합니다.
metadata.annotations.description
템플릿에 대한 설명을 지정합니다. 사용자가 배포 사항을 이해할 수 있도록 충분한 세부 정보와 배포 전에 알아야 할 경고 사항을 포함합니다. README 파일과 같은 추가 정보에 대한 링크도 제공해야 합니다. 단락을 생성하기 위해 줄 바꿈을 포함할 수 있습니다.
metadata.annotations.openshift.io/long-description
추가 템플릿 설명을 지정합니다. 이는 서비스 카탈로그에 의해 표시될 수 있습니다.
metadata.annotations.tags
검색 및 그룹화에 필요한 템플릿과 연결할 태그를 지정합니다. 템플릿을 제공된 카탈로그 카테고리 중 하나로 그룹화하는 태그를 추가합니다. 콘솔 상수 파일에 있는 CATALOG_CATEGORIES의 id 및 categoryAliases를 참조합니다. 카테고리는 전체 클러스터에 맞게 사용자 정의할 수도 있습니다.
metadata.annotations.iconClass

웹 콘솔에서 템플릿과 함께 표시할 아이콘을 지정합니다.

다음은 사용 가능한 아이콘 목록입니다.

  • icon-3scale
  • icon-aerogear
  • icon-amq
  • icon-angularjs
  • icon-ansible
  • icon-apache
  • icon-beaker
  • icon-camel
  • icon-capedwarf
  • icon-cassandra
  • icon-catalog-icon
  • icon-clojure
  • icon-codeigniter
  • icon-cordova
  • icon-datagrid
  • icon-datavirt
  • icon-debian
  • icon-decisionserver
  • icon-django
  • icon-dotnet
  • icon-drupal
  • icon-eap
  • icon-elastic
  • icon-erlang
  • icon-fedora
  • icon-freebsd
  • icon-git
  • icon-github
  • icon-gitlab
  • icon-glassfish
  • icon-go-gopher
  • icon-golang
  • icon-grails
  • icon-hadoop
  • icon-haproxy
  • icon-helm
  • icon-infinispan
  • icon-jboss
  • icon-jenkins
  • icon-jetty
  • icon-joomla
  • icon-jruby
  • icon-js
  • icon-knative
  • icon-kubevirt
  • icon-laravel
  • icon-load-balancer
  • icon-mariadb
  • icon-mediawiki
  • icon-memcached
  • icon-mongodb
  • icon-mssql
  • icon-mysql-database
  • icon-nginx
  • icon-nodejs
  • icon-openjdk
  • icon-openliberty
  • icon-openshift
  • icon-openstack
  • icon-other-linux
  • Ironic-other-known
  • icon-perl
  • icon-phalcon
  • icon-php
  • icon-play
  • iconpostgresql
  • icon-processserver
  • icon-python
  • icon-quarkus
  • icon-rabbitmq
  • icon-rails
  • icon-redhat
  • icon-redis
  • icon-rh-integration
  • icon-rh-spring-boot
  • icon-rh-tomcat
  • icon-ruby
  • icon-scala
  • icon-serverlessfx
  • icon-shadowman
  • icon-spring-boot
  • icon-spring
  • icon-sso
  • icon-stackoverflow
  • icon-suse
  • icon-symfony
  • icon-tomcat
  • icon-ubuntu
  • icon-vertx
  • icon-wildfly
  • icon-windows
  • icon-wordpress
  • icon-xamarin
  • icon-zend
metadata.annotations.openshift.io/provider-display-name
템플릿을 제공하는 사람 또는 조직의 이름을 지정합니다.
metadata.annotations.openshift.io/documentation-url
템플릿에 대한 추가 문서를 참조하는 URL을 지정합니다.
metadata.annotations.openshift.io/support-url
템플릿에 대한 지원을 받을 수 있는 URL을 지정합니다.
message
이 템플릿이 인스턴스화될 때 표시되는 명령 메시지를 지정합니다. 이 필드는 새로 생성된 리소스 사용 방법을 사용자에게 알려주어야 합니다. 생성된 인증 정보 및 기타 매개변수가 출력에 포함될 수 있도록 표시 전에 메시지에서 매개변수 대체가 수행됩니다. 사용자가 따라야 하는 다음 단계 문서에 대한 링크를 포함합니다.

3.1.7.2. 템플릿 레이블 작성

템플릿에서 생성된 모든 오브젝트에 레이블을 지정하려면 템플릿 정의에 labels 섹션을 추가합니다. 사용자가 템플릿에서 생성된 리소스를 식별하고 관리할 수 있도록 매개변수화된 레이블을 사용합니다.

다음은 템플릿 오브젝트 레이블의 예입니다.

kind: "Template"
apiVersion: "v1"
...
labels:
  template: "cakephp-mysql-example"
  app: "${NAME}"

다음과 같습니다.

labels.template
이 템플릿에서 생성된 모든 오브젝트에 적용되는 레이블을 지정합니다.
labels.app
이 템플릿에서 생성된 모든 오브젝트에도 적용되는 매개변수화된 레이블을 지정합니다. 매개변수 확장은 레이블 키와 값 둘 다에서 수행됩니다.

3.1.7.3. 템플릿 매개변수 작성

처리할 때 템플릿을 사용자 지정하려면 기본값 또는 생성된 값으로 매개변수를 정의하고 템플릿 필드에서 참조합니다. 문자열 또는 JSON 대체 구문을 사용하여 사용자별 값을 생성된 오브젝트에 전달합니다.

매개변수를 사용하면 템플릿을 처리할 때 값을 제공하거나 생성할 수 있습니다. 그러면 해당 값이 매개변수가 참조될 때마다 대체됩니다. 참조는 오브젝트 목록 필드의 어떤 필드에서든 정의할 수 있습니다. 임의의 암호를 생성하거나 템플릿을 사용자 정의하는 데 필요한 호스트 이름 또는 기타 사용자 특정 값을 제공할 수 있는 데 유용합니다. 매개변수는 다음 두 가지 방법으로 참조할 수 있습니다.

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

${PARAMETER_NAME} 구문을 사용하는 경우 여러 매개변수 참조가 단일 필드에서 결합될 수 있으며 참조는 "http://${PARAMETER_1}${PARAMETER_2}" 같이 고정된 데이터에 내에 포함될 수 있습니다. 매개변수 값이 둘 다 대체되며 결과 값은 인용된 문자열이 됩니다.

${{PARAMETER_NAME}} 구문을 사용하는 경우 단일 매개변수 참조만 허용되며 선행 및 후행 문자는 허용되지 않습니다. 대체가 수행된 후 결과가 유효한 JSON 오브젝트인 경우 결과 값이 인용되지 않습니다. 결과가 유효한 JSON 값이 아닌 경우 결과 값이 인용되고 표준 문자열로 처리됩니다.

단일 매개변수는 템플릿 내에서 여러 번 참조될 수 있으며 단일 템플릿 내에서 두 대체 구문을 사용하여 참조될 수도 있습니다.

다른 값을 제공하지 않은 경우 사용되는 기본값을 제공할 수 있습니다.

다음은 명시적 값을 기본값으로 설정하는 예입니다.

parameters:
  - name: USERNAME
    description: "The user name for Joe"
    value: joe

매개변수 값은 매개변수 정의에 지정된 규칙을 기반으로 생성할 수도 있습니다.

parameters:
  - name: PASSWORD
    description: "The random user password"
    generate: expression
    from: "[a-zA-Z0-9]{12}"

이전 예에서 처리가 완료되면 모든 대문자 및 소문자 영문자와 숫자로 구성된 12자 길이의 임의의 암호가 생성됩니다.

사용 가능한 구문은 완전한 정규식 구문이 아닙니다. 하지만 \w, \d, \a, and \A 수정자를 사용할 수 있습니다.

  • [\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}과 동일합니다.
참고

템플릿이 YAML 또는 JSON으로 작성되었는지 여부에 따라 두 번째 백슬래시를 사용하여 백슬래시를 이스케이프해야 할 수 있습니다. 또한 수정자가 포함된 문자열 유형에 따라 달라집니다. 다음 예에서와 같습니다.

수정자가 포함된 YAML 템플릿 예

  parameters:
  - name: singlequoted_example
    generate: expression
    from: '[\A]{10}'
  - name: doublequoted_example
    generate: expression
    from: "[\\A]{10}"

수정자가 포함된 JSON 템플릿 예

{
    "parameters": [
       {
        "name": "json_example",
        "generate": "expression",
        "from": "[\\A]{10}"
       }
    ]
}

다음은 매개변수 정의 및 참조가 포함된 전체 템플릿의 예입니다.

kind: Template
apiVersion: template.openshift.io/v1
metadata:
  name: my-template
objects:
  - kind: BuildConfig
    apiVersion: build.openshift.io/v1
    metadata:
      name: cakephp-mysql-example
      annotations:
        description: Defines how to build the application
    spec:
      source:
        type: Git
        git:
          uri: "${SOURCE_REPOSITORY_URL}"
          ref: "${SOURCE_REPOSITORY_REF}"
        contextDir: "${CONTEXT_DIR}"
  - kind: DeploymentConfig
    apiVersion: apps.openshift.io/v1
    metadata:
      name: frontend
    spec:
      replicas: "${{REPLICA_COUNT}}"
parameters:
  - name: SOURCE_REPOSITORY_URL
    displayName: Source Repository URL
    description: The URL of the repository with your application source code
    value: https://github.com/sclorg/cakephp-ex.git
    required: true
  - name: GITHUB_WEBHOOK_SECRET
    description: A secret string used to configure the GitHub webhook
    generate: expression
    from: "[a-zA-Z0-9]{40}"
  - name: REPLICA_COUNT
    description: Number of replicas to run
    value: "2"
    required: true
message: "... The GitHub webhook secret is ${GITHUB_WEBHOOK_SECRET} ..."

다음과 같습니다.

spec.git.uri
템플릿을 처리할 때 SOURCE_REPOSITORY_URL 매개변수 값으로 대체할 값을 지정합니다.
spec.replicas
템플릿을 처리할 때 인용되지 않은 REPLICA_COUNT 매개변수 값으로 대체할 값을 지정합니다.
parameters.name
매개 변수의 이름을 지정합니다. 이 값은 템플릿 내에서 매개변수를 참조하는 데 사용됩니다.
parameters.displayName
매개변수의 사용자에게 친숙한 이름을 지정합니다. 이는 사용자에게 표시됩니다.
parameters.description
매개 변수에 대한 설명을 지정합니다. 예상 값에 대한 제약 조건을 비롯하여 매개변수의 목적에 대한 자세한 정보를 제공합니다. 설명은 콘솔 텍스트 표준을 따르기 위해 완전한 문장을 사용해야 합니다. 표시 이름과 중복되지 않게 하십시오.
parameters.value
템플릿을 처리할 때 값을 재정의하지 않는 경우 사용되는 매개변수의 기본값을 지정합니다. 암호 등에 기본값을 사용하지 말고 생성된 매개변수를 시크릿과 조합하여 사용하십시오.
parameters.required
이 매개변수가 필수임을 지정합니다. 즉, 빈 값으로 재정의할 수 없습니다. 매개변수가 기본값 또는 생성된 값을 제공하지 않으면 값을 제공해야 합니다.
parameters.generate
매개변수 값이 생성되도록 지정합니다.
parameters.from
생성기에 대한 입력을 지정합니다. 이 경우 생성기는 대문자 및 소문자를 포함하여 40자 길이의 영숫자 값을 생성합니다.
message
템플릿 메시지에 매개 변수를 포함할 수 있도록 지정합니다. 이 필드는 생성된 값에 대해 알려줍니다.

3.1.7.4. 템플릿 오브젝트 목록 작성

처리된 경우 템플릿이 생성하는 항목을 지정하려면 배포할 API 리소스로 오브젝트 목록을 정의합니다. 매개변수 값은 생성 전에 각 오브젝트 정의로 대체됩니다.

다음은 오브젝트 목록의 예입니다.

kind: "Template"
apiVersion: "v1"
metadata:
  name: my-template
objects:
  - kind: "Service"
    apiVersion: "v1"
    metadata:
      name: "cakephp-mysql-example"
      annotations:
        description: "Exposes and load balances the application pods"
    spec:
      ports:
        - name: "web"
          port: 8080
          targetPort: 8080
      selector:
        name: "cakephp-mysql-example"

다음과 같습니다.

objects.kind
이 템플릿에서 생성된 서비스의 정의를 지정합니다.
참고

오브젝트 정의 메타데이터에 고정된 namespace 필드 값이 포함된 경우 템플릿을 인스턴스화하는 동안 이 필드가 정의에서 제거됩니다. namespace 필드에 매개변수 참조가 포함된 경우 일반 매개변수 대체가 수행되고 결과 네임스페이스에 오브젝트가 생성됩니다. 이를 위해서는 해당 네임스페이스에서 오브젝트를 생성할 수 있는 권한이 있어야 합니다.

3.1.7.5. 템플릿을 바인딩 가능으로 표시

최종 사용자가 템플릿에서 프로비저닝된 서비스에 바인딩되지 않도록 template.openshift.io/bindable: "false" 주석을 템플릿 오브젝트에 추가합니다. 기본적으로 Template Service Broker는 서비스 카탈로그에서 각 템플릿 서비스를 바인딩할 수 있는 것으로 알립니다.

절차

  • template.openshift.io/bindable: "false" 주석을 템플릿에 추가하여 일반 사용자가 지정된 템플릿에서 프로비저닝된 서비스에 대해 바인딩하지 못하도록 합니다.

3.1.7.6. 템플릿 오브젝트 필드 노출

사용자가 템플릿 서비스에 바인딩할 때 연결 세부 정보를 반환하려면 template.openshift.io/expose- 또는 template.openshift.io/base64-expose- 주석을 ConfigMap,Secret,Service 또는 Route 오브젝트에 추가합니다. 그런 다음 바인딩 클라이언트에 필요한 인증 정보 및 끝점이 직접 수신됩니다.

접두사가 제거된 각 주석 키는 전달되어 bind 응답의 키가 됩니다.

각 주석 값은 Kubernetes JSONPath 표현식이며, 바인딩 시 이를 해석하여 bind 응답에서 값을 반환해야 하는 오브젝트 필드를 식별합니다.

참고

백슬래시로 이스케이프되지 않는 한 Kubernetes의 JSONPath 구현은 표현식의 위치와 관계없이 ., @ 및 기타와 같은 문자를 메타 문자로 해석합니다. 따라서 예를 들어 my.key 라는 ConfigMap 데이터를 참조하기 위해 필요한 JSONPath 표현식은 {.data['my\.key']} 입니다. JSONPath 표현식이 YAML로 작성되는 방법에 따라 추가 백슬래시가 필요할 수도 있습니다(예: "{.data['my\\.key']}").

다음은 노출되는 다양한 오브젝트의 필드의 예입니다.

kind: Template
apiVersion: template.openshift.io/v1
metadata:
  name: my-template
objects:
- kind: ConfigMap
  apiVersion: v1
  metadata:
    name: my-template-config
    annotations:
      template.openshift.io/expose-username: "{.data['my\\.username']}"
  data:
    my.username: foo
- kind: Secret
  apiVersion: v1
  metadata:
    name: my-template-config-secret
    annotations:
      template.openshift.io/base64-expose-password: "{.data['password']}"
  stringData:
    password: <password>
- kind: Service
  apiVersion: v1
  metadata:
    name: my-template-service
    annotations:
      template.openshift.io/expose-service_ip_port: "{.spec.clusterIP}:{.spec.ports[?(.name==\"web\")].port}"
  spec:
    ports:
    - name: "web"
      port: 8080
- kind: Route
  apiVersion: route.openshift.io/v1
  metadata:
    name: my-template-route
    annotations:
      template.openshift.io/expose-uri: "http://{.spec.host}{.spec.path}"
  spec:
    path: mypath
참고

Bind 응답 키/값 쌍은 시스템의 다른 부분에서 환경 변수로 사용될 수 있습니다. 따라서 접두사가 제거된 각 주석 키는 유효한 환경 변수 이름이어야 합니다. 유효한 이름은 A-Z,a-z 또는 _ 로 시작한 다음 0개 이상의 문자 A-Z,a-z,0-9 또는 _ 로 시작합니다.

이전 부분 템플릿을 기반으로 하는 bind 작업에 대한 응답의 예:

{
  "credentials": {
    "username": "foo",
    "password": "YmFy",
    "service_ip_port": "172.30.12.34:8080",
    "uri": "http://route-test.router.default.svc.cluster.local/mypath"
  }
}

절차

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

3.1.7.7. 템플릿 준비 상태 대기

키 리소스가 준비될 때까지 템플릿에서 리소스 생성을 지연하려면 template.alpha.openshift.io/wait-for-ready: "true" 주석을 지원되는 오브젝트 종류에 추가합니다. 서비스 카탈로그, Template Service Broker 및 TemplateInstance API는 주석이 달린 오브젝트가 준비되었다고 보고할 때까지 기다립니다.

절차를 시작하기 전에 다음 고려 사항을 확인하십시오.

  • 메모리, 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:
        ...

3.1.7.8. 기존 오브젝트에서 템플릿 생성

프로젝트의 기존 오브젝트에서 템플릿을 생성하려면 해당 오브젝트를 내보내고 매개변수 및 기타 템플릿 사용자 지정을 추가합니다. 배포된 리소스를 재사용하면 다른 사용자가 템플릿에서 일관되게 배포할 수 있는 작업 구성을 캡처할 수 있습니다.

절차

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

    $ oc get -o yaml all > <yaml_filename>

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

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

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

      참고

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

3.2. 개발자 화면을 사용하여 애플리케이션 생성

웹 콘솔의 개발자 화면을 사용하여 OpenShift Container Platform에서 애플리케이션을 생성하고 배포합니다.

웹 콘솔의 개발자 화면은 +추가 보기에서 애플리케이션 및 관련 서비스를 생성하고 OpenShift Container Platform에 배포할 수 있는 다음 옵션을 제공합니다.

  • 시작하기 리소스: 개발자 콘솔을 시작하는 데 도움이 되도록 이러한 리소스를 사용합니다. 옵션 메뉴 kebab 를 사용하여 헤더를 숨기도록 선택할 수 있습니다.

    • 샘플을 사용하여 애플리케이션 생성: 기존 코드 샘플을 사용하여 OpenShift Container Platform에서 애플리케이션 생성을 시작합니다.
    • 단계별 문서 빌드: 애플리케이션을 빌드하고 주요 개념과 용어를 숙지하기 위한 가이드 문서를 따릅니다.
    • 새로운 개발자 기능 살펴보기: 개발자 화면 내에서 새로운 기능과 리소스를 탐색합니다.
  • 개발자 카탈로그: 개발자 카탈로그를 탐색하여 필요한 애플리케이션, 서비스 또는 S2I(Source-to-Image) 빌더를 선택한 다음 프로젝트에 추가합니다.

    • all Services: 카탈로그를 검색하여 OpenShift Container Platform에서 서비스를 검색합니다.
    • Database: 필요한 데이터베이스 서비스를 선택하고 애플리케이션에 추가합니다.
    • Operator Backed: 필요한 Operator 관리 서비스를 선택하고 배포합니다.
    • Helm 차트: 애플리케이션 및 서비스 배포를 간소화하는 데 필요한 Helm 차트를 선택합니다.
    • Devfile: Devfile 레지스트리에서 devfile을 선택하여 개발 환경을 선언적으로 정의합니다.
    • 이벤트 소스: 특정 시스템의 이벤트 클래스에 관심을 등록할 이벤트 소스를 선택합니다.

      참고

      RHOAS Operator가 설치된 경우에도 Managed services 옵션을 사용할 수 있습니다.

  • Git 리포지토리: From Git, Devfile 또는 Dockerfile 옵션을 사용하여 Git 리포지토리에서 기존 코드베이스,Devfile 또는 Dockerfile을 가져와서 OpenShift Container Platform에서 애플리케이션을 빌드하고 배포합니다.
  • 컨테이너 이미지: 이미지 스트림 또는 레지스트리의 기존 이미지를 사용하여 OpenShift Container Platform에 배포합니다.
  • 파이프라인: Tekton 파이프라인을 사용하여 OpenShift Container Platform에서 소프트웨어 제공 프로세스를 위한 CI/CD 파이프라인을 생성합니다.
  • 서버리스: OpenShift Container Platform에서 상태 비저장 및 서버리스 애플리케이션을 생성, 빌드, 배포하기 위해 Serverless 옵션을 탐색합니다.

    • 채널: Knative 채널을 생성하여 메모리 내 및 안정적인 구현으로 이벤트 전달 및 지속성 계층을 생성합니다.
  • 샘플: 애플리케이션을 신속하게 생성, 빌드 및 배포하는 사용 가능한 샘플 애플리케이션을 탐색합니다.
  • 빠른 시작: 단계별 지침 및 작업을 사용하여 애플리케이션을 생성, 가져오기 및 실행할 수 있는 퀵 스타트 옵션을 탐색합니다.
  • 로컬 머신에서: 로컬 머신 타일에서 파일을 탐색하여 애플리케이션을 쉽게 빌드하고 배포하기 위해 로컬 시스템에 파일을 가져오거나 업로드합니다.

    • YAML 가져오기: YAML 파일을 업로드하여 애플리케이션을 빌드하고 배포하기 위한 리소스를 생성하고 정의합니다.
    • JAR 파일 업로드 : Java 애플리케이션을 빌드하고 배포할 JAR 파일을 업로드합니다.
  • 내 프로젝트 공유: 이 옵션을 사용하여 프로젝트에 사용자를 추가하거나 제거하고 접근성 옵션을 제공합니다.
  • Helm 차트 리포지터리: 이 옵션을 사용하여 네임스페이스에 Helm 차트 리포지터리를 추가합니다.
  • 리소스 다시 정렬: 이러한 리소스 를 사용하여 탐색 창에 추가된 고정된 리소스를 다시 정렬합니다. 탐색 창에서 마우스를 가져가면 고정된 리소스의 왼쪽에 드래그 앤 드롭 아이콘이 표시됩니다. 드래그된 리소스는 해당 리소스가 있는 섹션에서만 삭제할 수 있습니다.

파이프라인,이벤트 소스 및 가상 머신 가져오기 와 같은 특정 옵션은 OpenShift Pipelines Operator, OpenShift Serverless Operator 및 OpenShift Virtualization Operator가 설치된 경우에만 표시됩니다.

3.2.1. 사전 요구 사항

개발자 화면을 사용하여 애플리케이션을 생성하려면 다음 요구 사항이 충족되어야 합니다.

  • OpenShift 웹 콘솔에 로그인했습니다.
  • 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.

서버리스 애플리케이션을 생성하려면 위 사전 요구 사항에 다음 조건이 추가됩니다.

  • OpenShift Serverless Operator를 설치했습니다.
  • knative-serving 네임스페이스에 KnativeServing 리소스가 생성되어 있습니다.

3.2.2. 샘플 애플리케이션 생성

개발자 화면의 +추가 흐름에서 샘플 애플리케이션을 사용하여 애플리케이션을 빠르게 생성, 빌드 및 배포할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 로그인했으며 개발자 화면에 있습니다.

프로세스

  1. +추가 보기에서 샘플 타일을 클릭하여 샘플 페이지를 확인합니다.
  2. 샘플 페이지에서 사용 가능한 샘플 애플리케이션 중 하나를 선택하여 샘플 애플리케이션 생성 양식을 확인합니다.
  3. 샘플 애플리케이션 생성 양식에서 다음을 수행합니다.

    • 이름 필드에는 기본적으로 배포 이름이 표시됩니다. 필요에 따라 이 이름을 수정할 수 있습니다.
    • 빌더 이미지 버전에는 빌더 이미지가 기본적으로 선택되어 있습니다. 빌더 이미지 버전 드롭다운 목록을 사용하여 이 이미지 버전을 수정할 수 있습니다.
    • 샘플 Git 리포지토리 URL이 기본적으로 추가됩니다.
  4. 생성을 클릭하여 샘플 애플리케이션을 생성합니다. 샘플 애플리케이션의 빌드 상태가 토폴로지 보기에 표시됩니다. 샘플 애플리케이션이 생성되면 애플리케이션에 추가된 배포를 볼 수 있습니다.

3.2.3. 빠른 시작을 사용하여 애플리케이션 생성

빠른 시작 페이지에는 단계별 지침 및 작업을 사용하여 OpenShift Container Platform에서 애플리케이션을 생성, 가져오기, 실행하는 방법을 보여줍니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 로그인했으며 개발자 화면에 있습니다.

프로세스

  1. +추가 보기에서 시작하기 리소스 안내 문서로 빌드 모든 퀵 스타트 보기 링크를 클릭하여 빠른 시작 페이지를 확인합니다.
  2. 빠른 시작 페이지에서 사용하려는 퀵 스타트에 대한 타일을 클릭합니다.
  3. 시작을 클릭하여 퀵 스타트를 시작합니다.
  4. 표시되는 단계를 수행합니다.

3.2.4. Git에서 코드베이스를 가져와서 애플리케이션 생성

개발자 화면에서는 GitHub의 기존 코드베이스를 사용하여 OpenShift Container Platform에 애플리케이션을 생성, 빌드, 배포할 수 있습니다.

다음 절차에서는 개발자 화면의 Git에서 옵션을 통해 애플리케이션을 생성합니다.

프로세스

  1. +추가 보기에서 Git 리포지토리 타일의 Git에서 를 클릭하여 Git 에서 가져오기 양식을 확인합니다.
  2. Git 섹션에서 애플리케이션을 생성하는 데 사용할 코드베이스의 Git 리포지토리 URL을 입력합니다. 예를 들어 이 샘플 Node.js 애플리케이션의 URL https://github.com/sclorg/nodejs-ex를 입력합니다. 그런 다음 URL을 검증합니다.
  3. 선택 사항: 고급 Git 옵션 표시를 클릭하여 다음과 같은 세부 정보를 추가할 수 있습니다.

    • Git 참조: 애플리케이션을 빌드하는 데 사용할 특정 분기의 코드, 태그 또는 커밋을 가리킵니다.
    • 컨텍스트 디렉터리: 애플리케이션을 빌드하는 데 사용할 애플리케이션 소스 코드의 하위 디렉터리를 지정합니다.
    • 소스 시크릿: 프라이빗 리포지토리에서 소스 코드를 가져올 수 있는 자격 증명이 포함된 시크릿 이름을 생성합니다.
  4. 선택 사항: Git 리포지토리를 통해 Devfile, Dockerfile,Builder Image 또는 Serverless Function 를 가져와서 배포를 추가로 사용자 지정할 수 있습니다.

    • Git 리포지토리에 Devfile, Dockerfile, Builder Image 또는 func.yaml 이 포함된 경우 해당 경로 필드에 자동으로 감지되고 채워집니다.
    • 동일한 리포지토리에서 Devfile, Dockerfile 또는 Builder Image 가 감지되면 기본적으로 Devfile 이 선택됩니다.
    • Git 리포지토리에서 func.yaml 이 감지되면 가져오기 전략이 Serverless Function 으로 변경됩니다.
    • 또는 Git 리포지토리 URL을 사용하여 +추가 보기에서 Serverless 함수 생성 을 클릭하여 서버리스 함수를 생성할 수 있습니다.
    • 파일 가져오기 유형을 편집하고 다른 전략을 선택하려면 가져오기 전략 편집 옵션을 클릭합니다.
    • 여러 Devfiles , Dockerfile 또는 Builder Images가 감지되면 특정 인스턴스를 가져오려면 컨텍스트 디렉터리를 기준으로 각 경로를 지정합니다.
  5. Git URL을 검증하면 권장 빌더 이미지가 선택되고 별표가 표시됩니다. 빌더 이미지가 자동으로 탐지되지 않으면 빌더 이미지를 선택합니다. https://github.com/sclorg/nodejs-ex Git URL의 경우 기본적으로 Node.js 빌더 이미지가 선택됩니다.

    1. 선택 사항: 빌더 이미지 버전 드롭다운을 사용하여 버전을 지정합니다.
    2. 선택 사항: 가져오기 편집 전략을 사용하여 다른 전략을 선택합니다.
    3. 선택 사항: Node.js 빌더 이미지의 경우 Run command 필드를 사용하여 애플리케이션을 실행합니다.
  6. 일반 섹션에서 다음을 수행합니다.

    1. 애플리케이션 필드에서 애플리케이션 그룹화에 대한 고유 이름을 입력합니다(예: myapp). 애플리케이션 이름이 네임스페이스에서 고유해야 합니다.
    2. 기존 애플리케이션이 없는 경우 이 애플리케이션에 대해 생성된 리소스를 확인하는 이름 필드는 Git 리포지토리 URL에 따라 자동으로 채워집니다. 기존 애플리케이션이 있는 경우에는 기존 애플리케이션 내에 구성 요소를 배포하거나 새 애플리케이션을 생성하거나 구성 요소를 할당하지 않은 상태로 유지하도록 선택할 수 있습니다.

      참고

      리소스 이름은 네임스페이스에서 고유해야 합니다. 오류가 발생하면 리소스 이름을 수정합니다.

  7. 리소스 섹션에서 다음 옵션을 선택합니다.

    • 배포: 일반 Kubernetes 형식으로 애플리케이션을 생성합니다.
    • 배포 구성: OpenShift Container Platform 스타일 애플리케이션을 생성합니다.
    • 서버리스 배포: Knative 서비스를 생성합니다.

      참고

      애플리케이션 가져오기에 대한 기본 리소스 기본 설정을 설정하려면 사용자 환경 설정 애플리케이션 → 리소스 유형 필드로 이동합니다. 서버리스 배포 옵션은 OpenShift Serverless Operator가 클러스터에 설치된 경우에만 Git에서 가져오기 양식에 표시됩니다. 서버리스 기능을 생성하는 동안 리소스 섹션을 사용할 수 없습니다. 자세한 내용은 OpenShift Serverless 설명서를 참조하십시오.

  8. 파이프라인 섹션에서 파이프라인 추가를 선택한 다음 파이프라인 시각화 표시를 클릭하여 애플리케이션의 파이프라인을 확인합니다. 기본 파이프라인이 선택되지만 애플리케이션에 사용 가능한 파이프라인 목록에서 원하는 파이프라인을 선택할 수 있습니다.

    참고

    다음 기준이 충족되면 파이프라인 추가 확인란이 선택되고 PAC 구성이 기본적으로 선택됩니다.

    • Pipeline Operator가 설치됨
    • pipelines-as-code 가 활성화됨
    • .tekton 디렉터리는 Git 리포지토리에서 감지됩니다.
  9. 리포지토리에 Webhook를 추가합니다. PAC 구성이 선택되어 있고 iGitHub App이 설정된 경우 GitHub App 사용 및 webhook 설정 옵션이 표시됩니다. GitHub 앱이 설정되지 않은 경우 Webhook 설정 옵션만 볼 수 있습니다.

    1. 설정 Webhook로 이동하여 Webhook 추가를 클릭합니다.
    2. Payload URL 을 코드 컨트롤러 공용 URL로 Pipeline으로 설정합니다.
    3. 콘텐츠 유형을 application/json 으로 선택합니다.
    4. 웹 후크 시크릿을 추가하고 대체 위치에서 기록해 둡니다. 로컬 시스템에 openssl 을 설치하면 임의의 보안을 생성합니다.
    5. 개별 이벤트 선택을 클릭하고 Commit comments,Issue comments,Pull request, Pushes 이벤트를 선택합니다.
    6. Webhook 추가를 클릭합니다.
  10. 선택 사항: 고급 옵션 섹션에서 대상 포트 및 애플리케이션에 대한 경로 생성 은 공개적으로 사용 가능한 URL을 사용하여 애플리케이션에 액세스할 수 있도록 기본적으로 선택됩니다.

    애플리케이션이 기본 공용 포트인 80에 데이터를 노출하지 않으면 확인란을 지우고 노출하려는 대상 포트 번호를 설정합니다.

  11. 선택 사항: 다음 고급 옵션을 사용하여 애플리케이션을 추가로 사용자 지정할 수 있습니다.

    라우팅

    라우팅 링크를 클릭하면 다음 작업을 수행할 수 있습니다.

    • 경로의 호스트 이름을 사용자 지정합니다.
    • 라우터에서 감시하는 경로를 지정합니다.
    • 드롭다운 목록에서 트래픽의 대상 포트를 선택합니다.
    • Secure Route 확인란을 선택하여 경로를 보호합니다. 필요한 TLS 종료 유형을 선택하고 해당 드롭다운 목록에서 안전하지 않은 트래픽에 대한 정책을 설정합니다.

      참고

      서버리스 애플리케이션의 경우 Knative 서비스에서 위의 모든 라우팅 옵션을 관리합니다. 그러나 필요한 경우 트래픽에 대한 대상 포트를 사용자 지정할 수 있습니다. 대상 포트를 지정하지 않으면 기본 포트 8080이 사용됩니다.

    도메인 매핑

    서버리스 배포 를 생성하는 경우 생성하는 동안 Knative 서비스에 사용자 정의 도메인 매핑을 추가할 수 있습니다.

    • 고급 옵션 섹션에서 고급 라우팅 옵션 표시를 클릭합니다.

      • 서비스에 매핑하려는 도메인 매핑 CR이 이미 존재하는 경우 도메인 매핑 드롭다운 메뉴에서 선택할 수 있습니다.
      • 새 도메인 매핑 CR을 생성하려면 도메인 이름을 상자에 입력하고 만들기 옵션을 선택합니다. 예를 들어 example.com 을 입력하는 경우 만들기 옵션은 Create "example.com" 입니다.
    상태 점검

    애플리케이션에 준비 상태, 활성 상태, 시작 프로브를 추가하려면 상태 점검 링크를 클릭합니다. 모든 프로브에는 기본 데이터가 미리 채워져 있습니다. 기본 데이터가 포함된 프로브를 추가하거나 필요에 따라 사용자 지정할 수 있습니다.

    상태 프로브를 사용자 지정하려면 다음을 수행합니다.

    • 필요한 경우 준비 상태 프로브 추가를 클릭하여 컨테이너에서 요청을 처리할 준비가 되었는지 확인하도록 매개변수를 수정하고 확인 표시를 선택하여 프로브를 추가합니다.
    • 필요한 경우 활성 상태 프로브 추가를 클릭하여 컨테이너가 아직 실행되고 있는지 확인하도록 매개변수를 수정하고 확인 표시를 선택하여 프로브를 추가합니다.
    • 필요한 경우 시작 프로브 추가를 클릭하여 컨테이너 내 애플리케이션이 시작되었는지 확인하도록 매개변수를 수정하고 확인 표시를 선택하여 프로브를 추가합니다.

      각 프로브의 드롭다운 목록에서 요청 유형을 HTTP GET, 컨테이너 명령 또는 TCP 소켓으로 지정할 수 있습니다. 선택한 요청 유형에 따라 양식이 변경됩니다. 그런 다음 기타 매개변수(예: 프로브의 성공 및 실패 임계값, 컨테이너를 시작한 후 첫 번째 프로브를 수행할 때까지의 시간(초), 프로브 빈도, 시간 제한 값)에 대한 기본값을 수정할 수 있습니다.

    빌드 구성 및 배포

    빌드 구성 및 배포 링크를 클릭하여 해당 구성 옵션을 확인합니다. 일부 옵션은 기본적으로 선택되어 있습니다. 필요한 트리거 및 환경 변수를 추가하여 추가로 사용자 지정할 수 있습니다.

    서버리스 애플리케이션의 경우 Knative 구성 리소스가 DeploymentConfig 리소스 대신 배포에 필요한 상태를 유지 관리하므로 배포 옵션이 표시되지 않습니다.

    스케일링

    처음에 배포할 애플리케이션의 Pod 수 또는 인스턴스 수를 정의하려면 스케일링 링크를 클릭합니다.

    서버리스 배포를 생성하는 경우 다음 설정을 구성할 수도 있습니다.

    • min Pod 는 Knative 서비스에 대해 지정된 시간에 실행해야 하는 Pod 수의 하한값을 결정합니다. 이를 minScale 설정이라고도 합니다.
    • Max Pod 는 Knative 서비스에 대해 지정된 시간에 실행할 수 있는 Pod 수의 상한을 결정합니다. 이는 maxScale 설정이라고도 합니다.
    • 동시성 대상 에서는 지정된 시간에 애플리케이션의 각 인스턴스에 대해 원하는 동시 요청 수를 결정합니다.
    • 동시성 제한은 지정된 시간에 애플리케이션의 각 인스턴스에 허용되는 동시 요청 수에 대한 제한을 결정합니다.
    • 동시성 사용률 에 따라 Knative가 추가 트래픽을 처리하기 위해 추가 Pod를 확장하기 전에 충족해야 하는 동시 요청 제한의 백분율이 결정됩니다.
    • autoscale 창은 자동 스케일러가 패닉 모드가 아닌 경우 스케일링 결정에 대한 입력을 제공하기 위해 평균되는 시간 창을 정의합니다. 이 창에서 요청을 수신하지 않으면 서비스가 축소됩니다. 자동 스케일링 창의 기본 기간은 60s 입니다. 이를 안정적인 창이라고도 합니다.
    리소스 제한
    컨테이너 실행 시 컨테이너에서 사용하도록 보장하거나 허용하는 CPU 및 메모리 리소스의 양을 설정하려면 리소스 제한 링크를 클릭합니다.
    라벨
    라벨 링크를 클릭하여 애플리케이션에 사용자 정의 라벨을 추가합니다.
  12. 생성 을 클릭하여 애플리케이션을 생성하고 성공 알림이 표시됩니다. 토폴로지 보기에서 애플리케이션의 빌드 상태를 확인할 수 있습니다.

3.2.5. 컨테이너 이미지를 배포하여 애플리케이션 생성

내부 레지스트리의 외부 이미지 레지스트리 또는 이미지 스트림 태그를 사용하여 클러스터에 애플리케이션을 배포할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 로그인했으며 개발자 화면에 있습니다.

프로세스

  1. +추가 보기에서 컨테이너 이미지를 클릭하여 Deploy Images 페이지를 확인합니다.
  2. 이미지 섹션에서 다음을 수행합니다.

    1. 외부 레지스트리에서 이미지 이름을 선택하여 퍼블릭 또는 프라이빗 레지스트리에서 이미지를 배포하거나 내부 레지스트리에서 이미지를 선택하여 내부 레지스트리에서 이미지를 배포합니다.
    2. 런타임 아이콘 탭에서 이미지의 아이콘을 선택합니다.
  3. 일반 섹션에서 다음을 수행합니다.

    1. 애플리케이션 이름 필드에 애플리케이션 그룹화의 고유 이름을 입력합니다.
    2. 이름 필드에 고유 이름을 입력하여 이 구성 요소에 생성된 리소스를 식별합니다.
  4. 리소스 유형 섹션에서 생성할 리소스 유형을 선택합니다.

    1. 배포를 선택하여 Pod 및 ReplicaSet 오브젝트에 대한 선언적 업데이트를 활성화합니다.
    2. DeploymentConfig 를 선택하여 Pod 오브젝트의 템플릿을 정의하고 새 이미지 및 구성 소스 배포를 관리합니다.
    3. 유휴 상태일 때 스케일링을 0으로 활성화하려면 Serverless Deployment 를 선택합니다.
  5. 생성을 클릭합니다. 토폴로지 보기에서 애플리케이션의 빌드 상태를 볼 수 있습니다.

3.2.6. JAR 파일을 업로드하여 Java 애플리케이션 배포

웹 콘솔 개발자 화면을 사용하여 JAR 파일을 업로드하여 Java 애플리케이션을 배포할 수 있습니다.

다음 옵션을 사용하여 JAR 파일을 업로드할 수 있습니다.

  • 개발자 화면의 +추가 보기로 이동하여 From Local Machine 타일에서 JAR 파일 업로드 를 클릭합니다. JAR 파일을 찾아 선택하거나 JAR 파일을 드래그하여 애플리케이션을 배포합니다.
  • 토폴로지 보기로 이동하고 JAR 파일 업로드 옵션을 사용하거나 JAR 파일을 드래그하여 애플리케이션을 배포합니다.
  • 토폴로지 보기에서 컨텍스트 내 메뉴를 사용한 다음 JAR 파일 업로드 옵션을 사용하여 JAR 파일을 업로드하여 애플리케이션을 배포합니다.

사전 요구 사항

  • Cluster Samples Operator는 클러스터 관리자가 설치해야 합니다.
  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있으며 개발자 화면에 있습니다.

프로세스

  1. 토폴로지 보기에서 아무 곳이나 마우스 오른쪽 버튼으로 클릭하여 프로젝트에 추가 메뉴를 확인합니다.
  2. Add to Project 메뉴 위로 마우스를 올리면 메뉴 옵션을 확인한 다음 JAR 파일 업로드 옵션을 선택하여 JAR 파일 업로드 폼을 확인합니다. 또는 JAR 파일을 토폴로지 보기로 드래그할 수 있습니다.
  3. JAR 파일 필드에서 로컬 시스템에 필요한 JAR 파일을 찾아 업로드합니다. 또는 JAR 파일을 필드로 드래그할 수 있습니다. 호환되지 않는 파일 유형을 토폴로지 보기로 드래그하면 오른쪽 상단에 경고가 표시됩니다. 호환되지 않는 파일 유형이 업로드 양식의 필드에 삭제되면 필드 오류가 표시됩니다.
  4. 런타임 아이콘 및 빌더 이미지는 기본적으로 선택됩니다. 빌더 이미지가 자동으로 탐지되지 않으면 빌더 이미지를 선택합니다. 필요한 경우 빌더 이미지 버전 드롭다운 목록을 사용하여 버전을 변경할 수 있습니다.
  5. 선택 사항: 애플리케이션 이름 필드에 리소스 레이블링에 사용할 애플리케이션의 고유 이름을 입력합니다.
  6. 이름 필드에 연결된 리소스의 고유한 구성 요소 이름을 입력합니다.
  7. 선택 사항: 리소스 유형 드롭다운 목록을 사용하여 리소스 유형을 변경합니다.
  8. 고급 옵션 메뉴에서 애플리케이션에 대한 경로 생성을 클릭하여 배포된 애플리케이션의 공용 URL을 구성합니다.
  9. 생성을 클릭하여 애플리케이션을 배포합니다. JAR 파일이 업로드되고 있음을 알리는 알림이 표시됩니다. 알림에는 빌드 로그를 볼 수 있는 링크도 포함됩니다.

    참고

    빌드가 실행되는 동안 브라우저 탭을 종료하려고 하면 웹 경고가 표시됩니다.

    JAR 파일이 업로드되고 애플리케이션이 배포되면 토폴로지 보기에서 애플리케이션을 볼 수 있습니다.

3.2.7. Devfile 레지스트리를 사용하여 devfile에 액세스

개발자 화면의 +추가 흐름에서 devfile을 사용하여 devfile 커뮤니티 레지스트리의 사전 구성된 devfile에서 애플리케이션을 생성할 수 있습니다. devfile은 처음부터 구성하지 않고 개발 환경을 설명하는 이식 가능한 YAML 파일입니다.

절차

  1. 개발자 화면 +추가 개발자 카탈로그 모든 서비스로 이동합니다. 개발자 카탈로그 에서 사용 가능한 모든 서비스 목록이 표시됩니다.
  2. 유형에서 Devfiles 를 클릭하여 특정 언어 또는 프레임워크를 지원하는 devfile을 찾습니다. 또는 키워드 필터를 사용하여 이름, 태그 또는 설명을 사용하여 특정 devfile을 검색할 수도 있습니다.
  3. 애플리케이션을 생성하는 데 사용할 devfile을 클릭합니다. devfile 타일에는 이름, 설명, 공급자, devfile 문서 등 devfile의 세부 정보가 표시됩니다.
  4. 생성 을 클릭하여 애플리케이션을 생성하고 토폴로지 보기에서 애플리케이션을 확인합니다.

개발자 카탈로그를 사용하여 프로젝트에 추가할 수 있는 데이터베이스, 빌더 이미지 및 Helm 차트와 같은 Operator 지원 서비스를 기반으로 애플리케이션 및 서비스를 배포합니다.

개발자 카탈로그에는 애플리케이션 구성 요소, 서비스, 이벤트 소스, S2I(Source-to-Image) 빌더 컬렉션이 포함되어 있습니다. 클러스터 관리자는 카탈로그에서 사용 가능한 내용을 사용자 지정할 수 있습니다.

프로세스

  1. 개발자 화면에서 +추가 보기로 이동하고 개발자 카탈로그 타일에서 모든 서비스를 클릭하여 개발자 카탈로그 에서 사용 가능한 모든 서비스를 확인합니다.
  2. 모든 서비스에서 프로젝트에 추가해야 하는 서비스 종류 또는 구성 요소를 선택합니다. 이 예제에서는 데이터베이스를 선택하여 모든 데이터베이스 서비스를 나열하고 MariaDB를 클릭하여 서비스 세부 정보를 확인합니다.
  3. 템플릿 인스턴스화를 클릭하여 MariaDB 서비스 세부 정보가 자동으로 채워진 템플릿을 확인한 다음 생성을 클릭하여 토폴로지 보기에서 MariaDB 서비스를 생성하고 확인합니다.

    그림 3.1. 토폴로지의 MariaDB

    odc devcatalog 토폴로지

3.3. 설치된 Operator에서 애플리케이션 생성

클러스터 관리자가 설치한 Operator에서 OpenShift Container Platform 클러스터에 애플리케이션을 배포할 수 있습니다. 웹 콘솔에서 설치된 Operator 페이지를 사용하여 Operator CR(사용자 정의 리소스) API에서 애플리케이션을 생성합니다.

3.3.1. Operator를 사용하여 etcd 클러스터 생성

OpenShift Container Platform 웹 콘솔에서 etcd Operator를 사용하여 etcd 클러스터를 생성할 수 있습니다. Operator는 Pod, 서비스 및 기타 클러스터 리소스를 생성합니다.

사전 요구 사항

  • OpenShift Container Platform 5.0 클러스터에 액세스할 수 있습니다.
  • 관리자가 클러스터 수준에 etcd Operator를 이미 설치했습니다.

프로세스

  1. 이 절차를 위해 OpenShift Container Platform 웹 콘솔에 새 프로젝트를 생성합니다. 이 예제에서는 my-etcd라는 프로젝트를 사용합니다.
  2. 에코시스템 설치된 Operator 페이지로 이동합니다.

    클러스터 관리자가 클러스터에 설치하고 사용할 수 있는 Operator는 CSV(클러스터 서비스 버전) 목록으로 표시됩니다. 각 CSV는 Operator에서 제공하는 소프트웨어를 시작하고 관리합니다.

    작은 정보

    다음 명령을 실행하여 CLI에서 이 목록을 가져올 수 있습니다.

    $ oc get csv
  3. 자세한 내용과 사용 가능한 작업을 확인하려면 설치된 Operator 페이지에서 etcd Operator를 클릭합니다.

    제공된 API 아래에 표시된 대로 이 Operator는 etcd 클러스터 리소스인 EtcdCluster 리소스 중 하나를 포함하여 세 가지 새로운 리소스 유형을 사용할 수 있습니다.

    이러한 오브젝트는 기본 제공 네이티브 Kubernetes 항목(예: Deployment 또는 ReplicaSet )과 유사하게 작동하지만 etcd 관리와 관련된 논리가 포함됩니다.

  4. 새 etcd 클러스터를 생성합니다.

    1. etcd 클러스터 API 상자에서 인스턴스 생성을 클릭합니다.
    2. 선택 사항: 클러스터 크기와 같은 EtcdCluster 오브젝트의 최소 시작 템플릿을 수정합니다.
    3. 생성 을 클릭하여 종료합니다. 그러면 Operator에서 새 etcd 클러스터의 Pod, 서비스 및 기타 구성 요소를 가동합니다.
  5. 예제 etcd 클러스터를 클릭합니다.
  6. Resources 탭을 클릭합니다.

    프로젝트에는 Operator가 생성 및 구성하는 여러 리소스가 포함되어 있습니다.

  7. 프로젝트의 다른 pod에서 데이터베이스에 액세스할 수 있는 Kubernetes 서비스가 있는지 확인합니다.
  8. 선택 사항: 다른 사용자에게 프로젝트에서 Operator 관리 애플리케이션을 생성할 수 있는 권한을 부여하려면 다음 명령을 실행하여 edit 역할을 추가합니다.

    $ oc policy add-role-to-user edit <user> -n <target_project>

    프로젝트에서 edit 역할이 있는 사용자는 etcd 클러스터와 같은 Operator 관리 애플리케이션 인스턴스를 생성, 관리 및 삭제할 수 있습니다.

결과

Pod가 비정상적인 상태가 되거나 클러스터의 노드 간에 마이그레이션될 때 실패에 반응하고 데이터를 재조정하는 etcd 클러스터가 있어야 합니다. 적절한 액세스 권한이 있는 클러스터 관리자 또는 개발자는 해당 애플리케이션과 함께 데이터베이스를 사용할 수 있습니다.

3.4. CLI를 사용하여 애플리케이션 생성

oc new-app 명령을 사용하여 Git 리포지토리, 컨테이너 이미지 또는 템플릿에서 OpenShift Container Platform 클러스터에 애플리케이션을 생성할 수 있습니다. 명령 플래그를 사용하여 이름, 레이블, 환경 변수, 대상 프로젝트 및 기타 배포 옵션을 사용자 지정합니다.

3.4.1. 소스 코드에서 애플리케이션 생성

oc new-app 명령을 사용하여 로컬 또는 원격 Git 리포지토리에서 OpenShift Container Platform 클러스터에 애플리케이션을 생성할 수 있습니다. command 플래그를 사용하여 특정 분기 또는 하위 디렉터리를 대상으로 지정하거나, 프라이빗 리포지토리에 인증하거나, 빌드 전략 및 빌더 이미지를 제어합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치하고 클러스터에 로그인했습니다.
  • 애플리케이션 소스 코드가 포함된 Git 리포지토리에 액세스할 수 있습니다.

절차

  1. 다음 명령을 실행하여 로컬 디렉터리의 Git 리포지토리에서 애플리케이션을 생성합니다.

    $ oc new-app /<path_to_source_code>
    참고

    로컬 Git 리포지토리를 사용하는 경우 리포지토리에 OpenShift Container Platform 클러스터에서 액세스할 수 있는 URL을 가리키는 origin이라는 원격이 있어야 합니다. 인식된 원격이 없는 경우 new-app 명령을 실행하면 바이너리 빌드가 생성됩니다.

  2. 다음 명령을 실행하여 공용 원격 Git 리포지토리에서 애플리케이션을 생성합니다.

    $ oc new-app https://github.com/sclorg/cakephp-ex
  3. 다음 명령을 실행하여 프라이빗 원격 Git 리포지토리에서 애플리케이션을 생성합니다.

    $ oc new-app https://github.com/<your_user>/<your_private_repo> --source-secret=yoursecret
    참고

    프라이빗 원격 Git 리포지토리를 사용하는 경우 --source-secret 플래그를 사용하여 리포지토리에 액세스할 소스 복제 보안을 지정합니다.

  4. 다음 명령을 실행하여 소스 리포지토리의 하위 디렉터리를 사용합니다.

    $ oc new-app https://github.com/sclorg/s2i-ruby-container.git \
        --context-dir=2.0/test/puma-test-app
  5. 다음 명령을 실행하여 Git 분기를 지정합니다.

    $ oc new-app https://github.com/openshift/ruby-hello-world.git#beta4
  6. 다음 명령을 실행하여 자동으로 감지된 빌드 전략을 재정의합니다.

    $ oc new-app /home/user/code/myapp --strategy=docker
    참고

    oc 명령을 실행하려면 빌드 소스가 포함된 파일이 원격 Git 리포지토리에 제공되어야 합니다. 모든 소스 빌드에 git remote -v를 사용해야 합니다.

  7. 빌더 이미지 및 소스 리포지토리를 지정합니다.

    1. 다음 명령을 실행하여 원격 리포지토리의 빌더 이미지 및 소스 리포지토리를 지정합니다.

      $ oc new-app myproject/my-ruby~https://github.com/openshift/ruby-hello-world.git
    2. 다음 명령을 실행하여 로컬 리포지토리의 빌더 이미지 및 소스 리포지토리를 지정합니다.

      $ oc new-app openshift/ruby-20-centos7:latest~/home/user/code/my-ruby-app

3.4.2. 소스 애플리케이션에 대한 전략 및 언어 탐지

oc new-app 명령에서 Git 리포지토리의 루트 또는 컨텍스트 디렉터리에서 파일을 검토하여 선택한 빌드 전략 및 언어 빌더를 확인할 수 있습니다. 이러한 감지 규칙을 사용하여 빌드 전략을 재정의하거나 자동 탐지가 적용되지 않을 때 빌더 이미지를 지정합니다.

3.4.2.1. 빌드 전략 탐지

OpenShift Container Platform은 특정 파일을 감지하여 사용할 빌드 전략을 자동으로 결정합니다.

  • 새 애플리케이션을 생성할 때 Jenkinsfile 이 소스 리포지토리의 루트 또는 지정된 컨텍스트 디렉터리에 있는 경우 OpenShift Container Platform은 파이프라인 빌드 전략을 생성합니다.

    참고

    파이프라인 빌드 전략은 더 이상 사용되지 않습니다. 대신 Red Hat OpenShift Pipelines를 사용하는 것이 좋습니다.

  • 새 애플리케이션을 생성할 때 Dockerfile 이 소스 리포지토리의 루트 또는 지정된 컨텍스트 디렉터리에 있는 경우 OpenShift Container Platform은 Docker 빌드 전략을 생성합니다.
  • Jenkinsfile 과 Dockerfile 이 탐지되지 않으면 OpenShift Container Platform에서 소스 빌드 전략을 생성합니다.

3.4.2.2. 언어 탐지

소스 빌드 전략을 사용하는 경우 new-app 은 리포지토리의 루트 또는 컨텍스트 디렉터리에 있는 특정 파일에서 언어 빌더를 감지합니다.

표 3.1. new-app에서 탐지하는 언어
언어파일

dotnet

project.json, *.csproj

jee

pom.xml

nodejs

app.json, package.json

perl

cpanfile, index.pl

php

composer.json, index.php

python

requirements.txt, setup.py

ruby

Gemfile, Rakefile, config.ru

scala

build.sbt

golang

Godeps, main.go

언어를 감지한 후 new-app 명령은 언어 이름과 일치하는 주석 또는 이미지 스트림을 사용하여 OpenShift Container Platform 서버에서 이미지 스트림 태그를 검색합니다. 일치 항목이 없는 경우 new-app 명령은 Docker Hub 레지스트리에서 이름을 기반으로 탐지된 언어와 일치하는 이미지를 검색합니다.

~ 구분자를 사용하여 이미지 및 리포지토리를 지정하면 빌드 전략 탐지 및 언어 탐지가 수행되지 않습니다.

참고

언어 탐지 기능에는 리포지토리를 복제하고 검사할 수 있도록 Git 클라이언트를 로컬에 설치해야 합니다. Git을 사용할 수 없는 경우 <image>~<repository> 구문으로 리포지토리에 사용할 빌더 이미지를 지정하여 언어 탐지 단계가 수행되지 않도록 수 있습니다.

-i <image> <repository > 호출을 실행하려면 new-app 에서 아티팩트 유형이 무엇인지 확인하기 위해 repository 를 복제해야 하므로 Git을 사용할 수 없는 경우 명령이 실패합니다.

-i < image > --code <repository > 호출을 실행하려면 new-app 이 소스의 빌더인지 데이터베이스 이미지와 같은 별도의 배포인지 확인하기 위해 repository 를 복제해야 합니다.

3.4.3. 이미지에서 애플리케이션 생성

oc new-app 명령을 사용하여 Docker Hub의 컨테이너 이미지, 프라이빗 레지스트리 또는 클러스터의 이미지 스트림에서 애플리케이션을 생성할 수 있습니다. 배포하려는 컨테이너 이미지 이름 또는 이미지 스트림을 알고 있는 경우 다음 절차를 사용하십시오.

컨테이너 이미지가 저장된 위치와 일치하는 명령을 사용합니다.

참고

로컬 Docker 리포지토리에서 이미지를 지정하는 경우 OpenShift Container Platform 클러스터 노드에서 동일한 이미지를 사용할 수 있는지 확인해야 합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치하고 클러스터에 로그인했습니다.
  • 배포할 컨테이너 이미지 이름 또는 이미지 스트림을 알고 있습니다.

절차

  • 다음 명령을 실행하여 Docker Hub MySQL 이미지에서 애플리케이션을 생성합니다.

    $ oc new-app mysql
  • 다음 명령에서 전체 이미지 경로를 지정하여 프라이빗 레지스트리의 이미지에서 애플리케이션을 생성합니다.

    $ oc new-app myregistry:5000/example/myimage
  • 다음 명령을 실행하여 기존 이미지 스트림 및 선택적 이미지 스트림 태그에서 애플리케이션을 생성합니다.

    $ oc new-app my-stream:v1

3.4.4. 템플릿에서 애플리케이션 생성

oc new-app 명령을 사용하여 프로젝트에 저장된 템플릿 또는 로컬 시스템의 템플릿 파일에서 애플리케이션을 생성할 수 있습니다. 템플릿 JSON 또는 YAML 파일이 있거나 현재 프로젝트의 템플릿 라이브러리에 템플릿이 있는 경우 다음 절차를 사용하십시오.

사전 요구 사항

  • OpenShift CLI(oc)를 설치하고 클러스터에 로그인했습니다.
  • 템플릿 JSON 또는 YAML 파일 또는 현재 프로젝트의 템플릿 라이브러리에 저장된 템플릿이 있습니다.

절차

  1. 다음 명령을 실행하여 현재 프로젝트의 템플릿 라이브러리에 애플리케이션 템플릿을 업로드합니다.

    $ oc create -f examples/sample-app/application-template-stibuild.json
  2. 다음 명령을 실행하여 저장된 템플릿에서 새 애플리케이션을 생성합니다.

    $ oc new-app ruby-helloworld-sample
  3. 다음 명령을 실행하여 OpenShift Container Platform에 저장하지 않고 로컬 파일 시스템의 템플릿 파일에서 새 애플리케이션을 생성합니다.

    $ oc new-app -f examples/sample-app/application-template-stibuild.json
  4. 다음 명령을 실행하여 애플리케이션을 생성할 때 template 매개변수 값을 설정합니다.

    $ oc new-app ruby-helloworld-sample \
        -p ADMIN_USERNAME=admin -p ADMIN_PASSWORD=mypassword
  5. 다음 내용으로 helloworld.params 와 같은 파일을 생성하여 템플릿 매개변수를 파일에 저장합니다.

    ADMIN_USERNAME=admin
    ADMIN_PASSWORD=mypassword

    템플릿을 인스턴스화할 때 해당 매개변수를 파일에 저장한 다음 해당 파일을 --param-file과 함께 사용할 수 있습니다. 표준 입력에서 매개변수를 읽으려면 --param-file=-을 사용합니다.

  6. 다음 명령을 실행하여 매개변수 파일을 사용하여 템플릿에서 새 애플리케이션을 생성합니다.

    $ oc new-app ruby-helloworld-sample --param-file=helloworld.params
    참고

    표준 입력에서 매개변수를 읽으려면 --param-file=- 을 사용합니다.

3.4.5. 애플리케이션 생성을 위한 사용자 정의 옵션

oc new-app 명령에서 이름, 레이블, 환경 변수, 대상 프로젝트 및 기타 옵션을 설정하여 애플리케이션을 생성하는 방법을 사용자 지정할 수 있습니다. 이러한 플래그를 사용하여 배포 전에 명령이 생성하는 오브젝트를 제어합니다.

표 3.2. new-app 출력 오브젝트
개체설명

BuildConfig

명령줄에 지정된 각 소스 리포지토리에 대해 BuildConfig 오브젝트가 생성됩니다. BuildConfig 오브젝트는 사용할 전략, 소스 위치, 빌드 출력 위치를 지정합니다.

ImageStreams

BuildConfig 오브젝트의 경우 일반적으로 두 개의 이미지 스트림이 생성됩니다. 하나는 입력 이미지를 나타냅니다. 소스 빌드에서 이 이미지는 빌더 이미지입니다. Docker 빌드에서는 출처 이미지에 해당합니다. 두 번째 이미지는 출력 이미지를 나타냅니다. 컨테이너 이미지가 new-app에 입력으로 지정되면 해당 이미지에도 이미지 스트림이 생성됩니다.

DeploymentConfig

DeploymentConfig 오브젝트는 빌드 출력 또는 지정된 이미지를 배포하기 위해 생성됩니다. new-app 명령은 결과 DeploymentConfig 오브젝트에 포함된 컨테이너에 지정된 모든 Docker 볼륨에 대해 emptyDir 볼륨을 생성합니다.

Service

new-app 명령은 입력 이미지에서 노출된 포트를 탐지합니다. 가장 낮은 숫자의 노출된 포트를 사용하여 해당 포트를 노출하는 서비스를 생성합니다. 다른 포트를 공개하려면 new-app 을 완료한 후 oc expose 명령을 사용하여 추가 서비스를 생성합니다.

기타

템플릿에 따라 템플릿에서 애플리케이션을 생성할 때 기타 오브젝트를 생성할 수 있습니다.

3.4.5.1. 환경 변수 지정

템플릿, 소스 또는 이미지에서 애플리케이션을 생성할 때 -e|--env 인수를 사용하여 런타임 시 환경 변수를 애플리케이션 컨테이너에 전달할 수 있습니다.

$ oc new-app openshift/postgresql-92-centos7 \
    -e POSTGRESQL_USER=user \
    -e POSTGRESQL_DATABASE=db \
    -e POSTGRESQL_PASSWORD=password

이 변수는 --env-file 인수를 사용하여 파일에서 읽을 수도 있습니다. 다음은 postgresql.env라는 예제 파일입니다.

POSTGRESQL_USER=user
POSTGRESQL_DATABASE=db
POSTGRESQL_PASSWORD=password

파일에서 변수를 읽습니다.

$ oc new-app openshift/postgresql-92-centos7 --env-file=postgresql.env

또한 --env-file=- 인수를 사용하여 환경 변수를 표준 입력에 제공할 수 있습니다.

$ cat postgresql.env | oc new-app openshift/postgresql-92-centos7 --env-file=-
참고

new-app 처리의 일부로 생성된 모든 BuildConfig 오브젝트는 -e|--env 또는 --env-file 인수로 전달되는 환경 변수를 통해 업데이트되지 않습니다.

3.4.5.2. 빌드 환경 변수 지정

템플릿, 소스 또는 이미지에서 애플리케이션을 생성할 때 --build-env 인수를 사용하여 런타임 시 환경 변수를 빌드 컨테이너에 전달할 수 있습니다.

$ oc new-app openshift/ruby-23-centos7 \
    --build-env HTTP_PROXY=http://myproxy.net:1337/ \
    --build-env GEM_HOME=~/.gem

이 변수는 --build-env-file 인수를 사용하여 파일에서 읽을 수도 있습니다. 다음은 ruby.env라는 예제 파일입니다.

HTTP_PROXY=http://myproxy.net:1337/
GEM_HOME=~/.gem

파일에서 변수를 읽습니다.

$ oc new-app openshift/ruby-23-centos7 --build-env-file=ruby.env

또한 --build-env-file=-을 사용하여 환경 변수를 표준 입력에 제공할 수 있습니다.

$ cat ruby.env | oc new-app openshift/ruby-23-centos7 --build-env-file=-

3.4.5.3. 라벨 지정

소스, 이미지 또는 템플릿에서 애플리케이션을 생성할 때는 -l|--label 인수를 사용하여 생성된 오브젝트에 라벨을 추가할 수 있습니다. 라벨을 사용하면 애플리케이션과 관련된 오브젝트를 전체적으로 선택, 구성, 삭제할 수 있습니다.

$ oc new-app https://github.com/openshift/ruby-hello-world -l name=hello-world

3.4.5.4. 생성하지 않고 출력 보기

yaml 또는 json 값과 함께 -o 또는 --output 을 사용하여 오브젝트를 생성하지 않고 오브젝트를 미리 볼 수 있습니다. 출력을 파일로 리디렉션하고 파일을 편집한 다음 oc create 를 사용하여 오브젝트를 만듭니다.

파일에 new-app 출력 작성

$ oc new-app https://github.com/openshift/ruby-hello-world \
    -o yaml > myapp.yaml

편집된 파일에서 오브젝트 생성

$ oc create -f myapp.yaml

3.4.5.5. 다양한 이름으로 오브젝트 생성

new-app으로 생성한 오브젝트는 일반적으로 소스 리포지토리 또는 해당 오브젝트를 생성하는 데 사용된 이미지의 이름을 따서 이름이 지정됩니다. 명령에 --name 플래그를 추가하여 생성한 오브젝트의 이름을 설정할 수 있습니다.

$ oc new-app https://github.com/openshift/ruby-hello-world --name=myapp

3.4.5.6. 다른 프로젝트에서 오브젝트 생성

일반적으로 new-app은 현재 프로젝트에서 오브젝트를 생성합니다. 그러나 -n|--namespace 인수를 사용하면 다른 프로젝트에서 오브젝트를 생성할 수 있습니다.

$ oc new-app https://github.com/openshift/ruby-hello-world -n myproject

3.4.5.7. 여러 오브젝트 생성

new-app 에 여러 매개변수를 지정하여 여러 애플리케이션을 생성할 수 있습니다. 명령 줄에서 지정된 라벨은 단일 명령으로 생성된 모든 개체에 적용됩니다. 환경 변수는 소스 또는 이미지에서 생성한 모든 구성 요소에 적용됩니다.

소스 리포지토리 및 Docker Hub 이미지에서 애플리케이션을 생성하려면 다음을 실행합니다.

$ oc new-app https://github.com/openshift/ruby-hello-world mysql
참고

소스 코드 리포지토리와 빌더 이미지가 별도의 인수로 지정되면 new-app에서 빌더 이미지를 소스 코드 저장소의 빌더로 사용합니다. 이를 원하지 않는 경우 ~ 구분자를 사용하여 소스에 필요한 빌더 이미지를 지정합니다.

3.4.5.8. 단일 Pod에서 이미지 및 소스 그룹화

단일 Pod에서 여러 이미지를 함께 배포할 수 있습니다. 함께 그룹화할 이미지를 지정하려면 + 구분자를 사용합니다. --group 명령줄 인수를 사용하여 함께 그룹화해야 하는 이미지를 지정할 수도 있습니다. 소스 리포지토리에서 빌드한 이미지를 다른 이미지와 함께 그룹화하려면 그룹의 소스에 대한 빌더 이미지를 지정합니다.

$ oc new-app ruby+mysql

소스에서 빌드한 이미지를 외부 이미지와 함께 배포하려면 다음을 실행합니다.

$ oc new-app \
    ruby~https://github.com/openshift/ruby-hello-world \
    mysql \
    --group=ruby+mysql

3.4.5.9. 이미지, 템플릿 및 기타 입력 검색

oc new-app 명령에 대한 이미지, 템플릿 및 기타 입력을 검색하려면 --search 및 --list플래그를 추가합니다. 예를 들어 PHP를 포함하는 모든 이미지 또는 템플릿을 찾으려면 다음을 실행합니다.

$ oc new-app --search php

3.4.5.10. 가져오기 모드 설정

oc new-app 을 사용할 때 가져오기 모드를 설정하려면 --import-mode 플래그를 추가합니다. 이 플래그는 각각 단일 하위 최단 또는 모든 매니페스트를 사용하여 이미지 스트림을 생성하는 옵션을 제공하는 Legacy 또는 PreserveOriginal 을 추가할 수 있습니다.

$ oc new-app --image=registry.redhat.io/ubi8/httpd-24:latest --import-mode=Legacy --name=test
$ oc new-app --image=registry.redhat.io/ubi8/httpd-24:latest --import-mode=PreserveOriginal --name=test

3.5. Ruby on Rails를 사용하여 애플리케이션 생성

로컬에서 개발을 통해 OpenShift Container Platform에서 Ruby on Rails 4 애플리케이션을 빌드하고 배포할 수 있습니다.

Git에 소스를 저장한 다음 데이터베이스, 프런트 엔드 및 경로 서비스를 배포합니다. 이 프로세스를 사용하면 클러스터에 별도의 서비스 세트로 배포하기 전에 로컬에서 애플리케이션을 검증할 수 있습니다.

주의

OpenShift Container Platform에 애플리케이션을 배포하기 전에 이 튜토리얼의 각 부분을 완료해야 합니다. 단계가 실패하면 계속하기 전에 모든 이전 단계가 성공적으로 완료되었는지 확인합니다.

3.5.1. 사전 요구 사항

  • Ruby on Rails에 대한 기본적인 지식이 있습니다.
  • Ruby 2.0.0+, Rubygems 및 Bundler가 로컬로 설치되어 있습니다.
  • 기본적인 Git 지식이 있습니다.
  • OpenShift Container Platform 4의 실행 중인 인스턴스가 있습니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • 실행 중인 OpenShift Container Platform 클러스터에 로그인되어 있습니다.

3.5.2. 데이터베이스 설정

Ruby on Rails 개발을 위해 로컬 시스템에 PostgreSQL을 설치할 수 있습니다. 그러면 OpenShift Container Platform에 배포하기 전에 애플리케이션을 개발하고 테스트하는 동안 연결할 로컬 데이터베이스가 제공됩니다.

절차

  1. 다음 명령을 실행하여 데이터베이스를 설치합니다.

    $ sudo yum install -y postgresql postgresql-server postgresql-devel
  2. 다음 명령을 실행하여 데이터베이스를 초기화합니다.

    $ sudo postgresql-setup initdb

    이 명령은 데이터를 저장할 /var/lib/pgsql/data 디렉토리를 생성합니다.

  3. 다음 명령을 실행하여 데이터베이스를 시작합니다.

    $ sudo systemctl start postgresql.service
  4. 데이터베이스가 실행 중이면 다음 명령을 실행하여 rails 사용자를 생성합니다.

    $ sudo -u postgres createuser -s rails
    참고

    생성된 사용자에게는 암호가 없습니다.

3.5.3. 애플리케이션 작성

PostgreSQL을 사용하는 Ruby on Rails 애플리케이션을 생성할 수 있습니다. Rails gem을 설치하고 database.yml 파일을 구성하고 개발 및 테스트 데이터베이스를 초기화합니다. 이러한 단계를 수행하면 개발 및 테스트 환경 모두에서 애플리케이션이 PostgreSQL과 상호 작용할 수 있습니다.

절차

  1. 다음 명령을 실행하여 Rails gem을 설치합니다.

    $ gem install rails

    출력 예

    Successfully installed rails-4.3.0
    1 gem installed

  2. 다음 명령을 실행하여 PostgreSQL을 데이터베이스로 사용하여 새 애플리케이션을 생성합니다.

    $ rails new rails-app --database=postgresql
  3. 다음 명령을 실행하여 새 애플리케이션 디렉터리로 변경합니다.

    $ cd rails-app
  4. 이미 애플리케이션이 있는 경우 PostgreSQL 어댑터 gem(pg)이 Gemfile 에 있는지 확인합니다. 없는 경우 gem을 추가하여 Gemfile을 편집합니다.

    gem 'pg'
  5. 다음 명령을 실행하여 모든 종속 항목과 함께 새 Gemfile.lock 을 생성합니다.

    $ bundle install
  6. 다음 예와 같이 postgresql 어댑터를 사용하도록 config/database.yml 파일의 default 섹션을 업데이트합니다.

    default: &default
      adapter: postgresql
      encoding: unicode
      pool: 5
      host: localhost
      username: rails
      password: <password>
  7. 다음 명령을 실행하여 애플리케이션의 개발 및 테스트 데이터베이스를 생성합니다.

    $ rake db:create

3.5.3.1. 시작 페이지 생성

Rails 생성기를 실행하여 Rails 애플리케이션에 대한 사용자 정의 시작 페이지를 생성할 수 있습니다. 시작 페이지는 Rails 서버를 실행하고 브라우저에서 애플리케이션을 열 때 표시되는 콘텐츠를 제공합니다.

절차

  1. 다음 명령을 실행하여 Rails 생성기를 실행합니다.

    $ rails generate controller welcome index

    명령은 필요한 모든 파일을 생성합니다.

  2. 다음과 같이 config/routes.rb 파일에서 2행을 편집합니다.

    root 'welcome#index'
  3. Rails 서버를 실행하여 다음 명령을 실행하여 페이지를 사용할 수 있는지 확인합니다.

    $ rails server

    브라우저에서 http://localhost:3000 을 방문하여 페이지를 사용할 수 있는지 확인합니다. 페이지가 표시되지 않으면 서버 로그에 오류가 있는지 확인합니다.

3.5.3.2. OpenShift Container Platform의 애플리케이션 구성

OpenShift Container Platform에 대한 Rails 애플리케이션을 구성하려면 config/database.yml 파일의 default 섹션을 편집해야 합니다. 이는 애플리케이션이 클러스터의 PostgreSQL에 연결할 수 있도록 런타임에 올바른 데이터베이스 자격 증명을 제공하는 데 OpenShift Container Platform에 필요합니다.

절차

  • 다음과 같이 사전 정의된 변수를 사용하여 config/database.yml의 default 섹션을 편집합니다.

    config/database YAML 파일 샘플

    <% user = ENV.key?("POSTGRESQL_ADMIN_PASSWORD") ? "root" : ENV["POSTGRESQL_USER"] %>
    <% password = ENV.key?("POSTGRESQL_ADMIN_PASSWORD") ? ENV["POSTGRESQL_ADMIN_PASSWORD"] : ENV["POSTGRESQL_PASSWORD"] %>
    <% db_service = ENV.fetch("DATABASE_SERVICE_NAME","").upcase %>
    
    default: &default
      adapter: postgresql
      encoding: unicode
      # For details on connection pooling, see rails configuration guide
      # http://guides.rubyonrails.org/configuring.html#database-pooling
      pool: <%= ENV["POSTGRESQL_MAX_CONNECTIONS"] || 5 %>
      username: <%= user %>
      password: <%= password %>
      host: <%= ENV["#{db_service}_SERVICE_HOST"] %>
      port: <%= ENV["#{db_service}_SERVICE_PORT"] %>
      database: <%= ENV["POSTGRESQL_DATABASE"] %>

3.5.3.3. Git에 애플리케이션 저장

Rails 애플리케이션을 Git에 커밋하고 소스를 원격 리포지토리로 내보낼 수 있습니다. 원격 스토리지는 OpenShift Container Platform에 배포할 수 있는 소스를 유지합니다.

사전 요구 사항

  • Git이 설치되어 있어야 합니다.

절차

  1. 다음 명령을 실행하여 Rails 애플리케이션 디렉터리에 있는지 확인합니다.

    $ ls -1

    출력 예

    app
    bin
    config
    config.ru
    db
    Gemfile
    Gemfile.lock
    lib
    log
    public
    Rakefile
    README.rdoc
    test
    tmp
    vendor

  2. 다음 명령을 실행하여 Rails 애플리케이션 디렉터리에서 Git 리포지토리를 초기화합니다.

    $ git init
  3. 다음 명령을 실행하여 모든 애플리케이션 파일을 스테이징합니다.

    $ git add .
  4. 다음 명령을 실행하여 스테이징된 파일을 커밋합니다.

    $ git commit -m "initial commit"
  5. 애플리케이션에 대한 GitHub 리포지토리를 생성합니다.
  6. 다음 명령을 실행하여 git 리포지토리를 가리키는 remote를 설정합니다.

    $ git remote add origin git@github.com:<namespace/repository-name>.git
  7. 다음 명령을 실행하여 애플리케이션을 원격 Git 리포지토리로 내보냅니다.

    $ git push

3.5.4. OpenShift Container Platform에 애플리케이션 배포

OpenShift Container Platform 프로젝트를 생성하여 Ruby on Rails 애플리케이션을 배포할 수 있습니다. 이렇게 하면 데이터베이스, 프런트 엔드가 분리되고 OpenShift Container Platform이 독립적으로 관리할 수 있는 별도의 서비스로 라우팅됩니다.

OpenShift Container Platform에 애플리케이션을 배포하려면 다음 세 단계를 수행합니다.

  1. OpenShift Container Platform의 PostgreSQL 이미지에서 데이터베이스 서비스를 생성합니다.
  2. 데이터베이스 서비스에 연결된 OpenShift Container Platform의 Ruby 2.0 빌더 이미지와 Ruby on Rails 소스 코드에서 프런트 엔드 서비스를 생성합니다.
  3. 애플리케이션 경로를 생성합니다.

절차

  • 다음 명령을 실행하여 Rails 애플리케이션에 대한 프로젝트를 생성합니다.

    $ oc new-project rails-app --description="My Rails application" --display-name="Rails Application"

3.5.4.1. 데이터베이스 서비스 생성

Rails 애플리케이션에 대한 데이터베이스 서비스를 생성해야 합니다. 데이터베이스 이름, 사용자 이름, 암호에 대한 환경 변수를 설정해야 합니다. 서비스가 Rails 애플리케이션에 올바르게 연결하는 데 필요합니다.

이러한 환경 변수의 값을 선택한 값으로 변경할 수 있습니다. 변수는 다음과 같습니다.

  • POSTGRESQL_DATABASE
  • POSTGRESQL_USER
  • POSTGRESQL_PASSWORD

이러한 변수를 설정하면 다음이 수행됩니다.

  • 지정된 이름의 데이터베이스가 있습니다.
  • 지정된 이름의 사용자가 있습니다.
  • 사용자가 지정된 암호를 사용하여 지정된 데이터베이스에 액세스할 수 있습니다.

절차

  1. 다음 명령을 실행하여 데이터베이스 서비스를 생성합니다.

    $ oc new-app postgresql -e POSTGRESQL_DATABASE=db_name -e POSTGRESQL_USER=username -e POSTGRESQL_PASSWORD=password
    참고

    또한 데이터베이스 관리자 암호를 설정하려면 명령에 -e POSTGRESQL_ADMIN_PASSWORD=admin_pw 를 추가합니다.

  2. 다음 명령을 실행하여 Pod 상태를 모니터링합니다.

    $ oc get pods --watch

3.5.4.2. 프런트 엔드 서비스 생성

oc new-app 명령을 사용하여 프런트 엔드 서비스를 생성할 수 있습니다. 소스 리포지토리 및 데이터베이스 환경 변수를 지정하면 OpenShift Container Platform에서 애플리케이션 이미지를 빌드하고 클러스터에 배포할 수 있습니다.

절차

  1. 프런트 엔드 서비스를 생성하고 다음 명령을 실행하여 데이터베이스 서비스를 생성할 때 설정된 데이터베이스 관련 환경 변수를 지정합니다.

    $ oc new-app path/to/source/code --name=rails-app -e POSTGRESQL_USER=username -e POSTGRESQL_PASSWORD=password -e POSTGRESQL_DATABASE=db_name -e DATABASE_SERVICE_NAME=postgresql

    OpenShift Container Platform은 이 명령을 사용하여 소스 코드를 가져와서 빌더를 설정하고, 애플리케이션 이미지를 빌드하며, 새로 생성된 이미지를 지정된 환경 변수와 함께 배포합니다. 애플리케이션 이름은 rails-app으로 지정됩니다.

  2. 다음 명령을 실행하여 rails-app 배포 구성의 JSON 문서를 보고 환경 변수가 추가되었는지 확인합니다.

    $ oc get dc rails-app -o json

    출력에는 다음 섹션이 포함됩니다.

    출력 예

    env": [
        {
            "name": "POSTGRESQL_USER",
            "value": "username"
        },
        {
            "name": "POSTGRESQL_PASSWORD",
            "value": "password"
        },
        {
            "name": "POSTGRESQL_DATABASE",
            "value": "db_name"
        },
        {
            "name": "DATABASE_SERVICE_NAME",
            "value": "postgresql"
        }
    
    ],

  3. 다음 명령을 실행하여 빌드 프로세스를 확인합니다.

    $ oc logs -f build/rails-app-1
  4. 빌드가 완료되면 다음 명령을 실행하여 OpenShift Container Platform에서 실행 중인 Pod를 확인합니다.

    $ oc get pods

    출력에는 애플리케이션이 OpenShift Container Platform에서 실행 중인지 확인하는 myapp-<number>-<hash >로 시작하는 행이 포함됩니다.

  5. 애플리케이션이 작동하려면 데이터베이스 마이그레이션 스크립트를 실행하여 데이터베이스를 초기화해야 합니다. 이 작업을 수행하는 방법은 다음 두 가지입니다.

    • 실행 중인 프런트 엔드 컨테이너에서 수동으로 수행합니다.

      • 다음 명령을 실행하여 프런트 엔드 포드에 대한 원격 쉘을 엽니다.

        $ oc rsh <frontend_pod_id>
      • 다음 명령을 실행하여 컨테이너 내부에서 마이그레이션을 실행합니다.

        $ RAILS_ENV=production bundle exec rake db:migrate

        Rails 애플리케이션을 개발 또는 테스트 환경에서 실행하는 경우 RAILS_ENV 환경 변수를 지정할 필요가 없습니다.

    • 템플릿에 사전 배포 라이프사이클 후크를 추가하여 마이그레이션을 실행할 수도 있습니다.

3.5.4.3. 애플리케이션 경로 생성

oc expose service 명령을 사용하여 애플리케이션의 경로를 생성할 수 있습니다. 경로를 사용하면 클러스터 외부에서 애플리케이션에 액세스할 수 있습니다.

절차

  • 다음 명령을 실행하여 프런트 엔드 서비스에 외부에서 액세스할 수 있도록 합니다.

    $ oc expose service rails-app --hostname=www.example.com
    주의

    지정한 호스트 이름이 라우터의 IP 주소로 해석되는지 확인합니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동