🥇OpenShift의 최신 애플리케이션, 3부: 개발 환경으로서의 OpenShift 및 OpenShift Pipelines

안녕하세요, 이 블로그의 여러분! 이는 Red Hat OpenShift에서 최신 웹 애플리케이션을 배포하는 방법을 보여주는 시리즈의 세 번째 게시물입니다.

이전 두 게시물에서 우리는 단 몇 단계만으로 최신 웹 애플리케이션을 배포하는 방법과 프로덕션 배포를 조율하기 위해 체인 빌드를 사용하여 NGINX와 같은 기성 HTTP 서버 이미지와 함께 새 S2I 이미지를 사용하는 방법을 보여주었습니다. .

오늘은 OpenShift 플랫폼에서 애플리케이션용 개발 서버를 실행하고 이를 로컬 파일 시스템과 동기화하는 방법을 보여주고 OpenShift 파이프라인이 무엇인지, 연결된 어셈블리의 대안으로 어떻게 사용할 수 있는지에 대해 설명합니다.

개발 환경으로서의 OpenShift

개발 워크플로

에서 언급했듯이 첫 번째 게시물, 최신 웹 애플리케이션의 일반적인 개발 프로세스는 단순히 로컬 파일의 변경 사항을 추적하는 일종의 "개발 서버"입니다. 이러한 문제가 발생하면 애플리케이션 빌드가 트리거된 다음 브라우저에 업데이트됩니다.

대부분의 최신 프레임워크에서는 이러한 "개발 서버"가 해당 명령줄 도구에 내장되어 있습니다.

현지 사례

먼저, 애플리케이션을 로컬에서 실행할 때 이것이 어떻게 작동하는지 살펴보겠습니다. 응용 프로그램을 예로 들어 보겠습니다. 반응 이전 기사에서 다루었지만 다른 모든 최신 프레임워크에는 거의 동일한 워크플로 개념이 적용됩니다.
따라서 React 예제에서 "dev 서버"를 시작하려면 다음 명령을 입력합니다.

$ npm run start

그런 다음 터미널 창에 다음과 같은 내용이 표시됩니다.

그러면 애플리케이션이 기본 브라우저에서 열립니다.

이제 파일을 변경하면 브라우저에서 애플리케이션이 업데이트되어야 합니다.

좋습니다. 로컬 모드에서 개발하면 모든 것이 명확해집니다. 그런데 OpenShift에서 동일한 결과를 얻는 방법은 무엇입니까?

OpenShift의 개발 서버

기억하신다면, 이전 게시물, 우리는 소위 S2I 이미지의 실행 단계를 살펴보고 기본적으로 서비스 모듈이 웹 애플리케이션 서비스를 담당한다는 것을 확인했습니다.

그러나 자세히 살펴보면 스크립트 실행 이 예에서는 명령을 실행할 수 있는 $NPM_RUN 환경 변수가 포함되어 있습니다.

예를 들어 nodeshift 모듈을 사용하여 애플리케이션을 배포할 수 있습니다.

$ npx nodeshift --deploy.env NPM_RUN="yarn start" --dockerImage=nodeshift/ubi8-s2i-web-app

참고: 위의 예는 일반적인 아이디어를 설명하기 위해 축약되었습니다.

여기에서는 NPM_RUN 환경 변수를 배포에 추가했습니다. 이 변수는 OpenShift 포드 내에서 React 개발 서버를 시작하는 Yarn start 명령을 실행하도록 런타임에 지시합니다.

실행 중인 Pod의 로그를 보면 다음과 같습니다.

물론 이 모든 것은 변경 사항을 모니터링하지만 원격 서버에 있는 코드와 로컬 코드를 동기화할 수 있을 때까지 아무 것도 아닙니다.

원격 및 로컬 코드 동기화

다행스럽게도 nodeshift는 동기화에 쉽게 도움을 줄 수 있으며 watch 명령을 사용하여 변경 사항을 추적할 수 있습니다.

따라서 애플리케이션용 개발 서버를 배포하는 명령을 실행한 후 다음 명령을 안전하게 사용할 수 있습니다.

$ npx nodeshift watch

결과적으로 조금 더 일찍 생성한 실행 중인 포드에 연결되고 로컬 파일과 원격 클러스터의 동기화가 활성화되며 로컬 시스템의 파일에 대한 변경 사항이 모니터링되기 시작합니다.

따라서 이제 src/App.js 파일을 업데이트하면 시스템은 이러한 변경 사항에 반응하여 이를 원격 클러스터에 복사하고 개발 서버를 시작한 다음 브라우저에서 애플리케이션을 업데이트합니다.

그림을 완성하기 위해 전체 명령이 어떻게 보이는지 보여드리겠습니다.

$ npx nodeshift --strictSSL=false --dockerImage=nodeshift/ubi8-s2i-web-app --build.env YARN_ENABLED=true --expose --deploy.env NPM_RUN="yarn start" --deploy.port 3000

$ npx nodeshift watch --strictSSL=false

watch 명령은 oc rsync 명령 위에 추상화되어 있으며 작동 방식에 대해 자세히 알아볼 수 있습니다. 여기에.

이는 React에 대한 예이지만 다른 프레임워크에서도 똑같은 방법을 사용할 수 있습니다. 필요에 따라 NPM_RUN 환경 변수를 설정하기만 하면 됩니다.

오픈시프트 파이프라인

다음으로 OpenShift Pipelines와 같은 도구와 이를 체인 빌드의 대안으로 사용할 수 있는 방법에 대해 설명하겠습니다.

OpenShift 파이프라인이란 무엇입니까?

OpenShift Pipelines는 Tekton을 사용하여 파이프라인을 구성하도록 설계된 클라우드 네이티브 CI/CD 지속적인 통합 및 제공 시스템입니다. Tekton은 기본 계층에서 추상화하여 다양한 플랫폼(Kubernetes, 서버리스, 가상 머신 등)에서 배포를 자동화할 수 있는 유연한 오픈 소스 Kubernetes 기반 CI/CD 프레임워크입니다.

이 문서를 이해하려면 파이프라인에 대한 지식이 필요하므로 먼저 읽어보는 것이 좋습니다. 공식 교과서.

작업 환경 설정

이 문서의 예제를 실행하려면 먼저 작업 환경을 준비해야 합니다.

OpenShift 4 클러스터를 설치하고 구성합니다. 이 예제에서는 이를 위해 CodeReady Containers(CRD)를 사용합니다. 설치 지침은 찾을 수 있습니다. 여기에.
클러스터가 준비되면 여기에 Pipeline Operator를 설치해야 합니다. 두려워하지 마십시오. 쉽습니다. 설치 지침 여기에.
다운로드 텍톤 CLI (ㅋ) 여기에.
create-react-app 명령줄 도구를 실행하여 배포할 애플리케이션을 생성합니다(이것은 간단한 애플리케이션입니다. 반응).
(선택 사항) 저장소를 복제하여 npm install과 npm start를 사용하여 로컬에서 예제 애플리케이션을 실행합니다.

애플리케이션 저장소에는 애플리케이션을 배포하는 데 사용되는 Kubernetes/OpenShift YAML을 포함하는 k8s 폴더도 있습니다. 여기서 생성할 작업, ClusterTasks, 리소스 및 파이프라인이 있습니다. 저장소.

시작하자

예제의 첫 번째 단계는 OpenShift 클러스터에 새 프로젝트를 생성하는 것입니다. 이 프로젝트 webapp-pipeline을 호출하고 다음 명령을 사용하여 생성해 보겠습니다.

$ oc new-project webapp-pipeline

이 프로젝트 이름은 나중에 코드에 표시되므로 다른 이름으로 지정하기로 결정한 경우 그에 따라 예제 코드를 편집하는 것을 잊지 마세요. 이 시점부터 우리는 하향식이 아닌 상향식으로 진행합니다. 즉, 먼저 컨베이어의 모든 구성 요소를 만든 다음 컨베이어 자체를 만듭니다.

그럼 우선...

작업

파이프라인 내에 애플리케이션을 배포하는 데 도움이 되는 몇 가지 작업을 만들어 보겠습니다. 첫 번째 작업인 apply_manifests_task는 애플리케이션의 k8s 폴더에 있는 Kubernetes 리소스(서비스, 배포 및 경로)의 YAML을 적용하는 일을 담당합니다. 두 번째 작업인 update_deployment_task는 이미 배포된 이미지를 파이프라인에서 생성된 이미지로 업데이트하는 일을 담당합니다.

아직 명확하지 않더라도 걱정하지 마세요. 실제로 이러한 작업은 유틸리티와 비슷하며 나중에 좀 더 자세히 살펴보겠습니다. 지금은 그냥 만들어 보겠습니다.

$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/tasks/update_deployment_task.yaml
$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/tasks/apply_manifests_task.yaml

그런 다음 tkn CLI 명령을 사용하여 작업이 생성되었는지 확인합니다.

$ tkn task ls

NAME                AGE
apply-manifests     1 minute ago
update-deployment   1 minute ago

참고: 이는 현재 프로젝트에 대한 로컬 작업입니다.

클러스터 작업

클러스터 작업은 기본적으로 단순 작업과 동일합니다. 즉, 특정 작업을 실행할 때 어떤 방식으로든 결합되는 재사용 가능한 단계 모음입니다. 차이점은 클러스터 작업은 클러스터 내의 모든 곳에서 사용할 수 있다는 것입니다. Pipeline Operator를 추가할 때 자동으로 생성되는 클러스터 작업 목록을 보려면 tkn CLI 명령을 다시 사용하겠습니다.

$ tkn clustertask ls

NAME                       AGE
buildah                    1 day ago
buildah-v0-10-0            1 day ago
jib-maven                  1 day ago
kn                         1 day ago
maven                      1 day ago
openshift-client           1 day ago
openshift-client-v0-10-0   1 day ago
s2i                        1 day ago
s2i-go                     1 day ago
s2i-go-v0-10-0             1 day ago
s2i-java-11                1 day ago
s2i-java-11-v0-10-0        1 day ago
s2i-java-8                 1 day ago
s2i-java-8-v0-10-0         1 day ago
s2i-nodejs                 1 day ago
s2i-nodejs-v0-10-0         1 day ago
s2i-perl                   1 day ago
s2i-perl-v0-10-0           1 day ago
s2i-php                    1 day ago
s2i-php-v0-10-0            1 day ago
s2i-python-3               1 day ago
s2i-python-3-v0-10-0       1 day ago
s2i-ruby                   1 day ago
s2i-ruby-v0-10-0           1 day ago
s2i-v0-10-0                1 day ago

이제 두 개의 클러스터 작업을 생성해 보겠습니다. 첫 번째는 S2I 이미지를 생성하여 내부 OpenShift 레지스트리로 보냅니다. 두 번째는 이미 콘텐츠로 구축한 애플리케이션을 사용하여 NGINX를 기반으로 이미지를 구축하는 것입니다.

이미지 생성 및 보내기

첫 번째 작업을 생성할 때 연결된 어셈블리에 대해 이전 기사에서 이미 수행한 작업을 반복합니다. S2I 이미지(ubi8-s2i-web-app)를 사용하여 애플리케이션을 "구축"했고 결국 OpenShift 내부 레지스트리에 이미지가 저장되었다는 점을 기억하세요. 이제 이 S2I 웹 앱 이미지를 사용하여 앱용 DockerFile을 생성한 다음 Buildah를 사용하여 실제 빌드를 수행하고 결과 이미지를 OpenShift 내부 레지스트리에 푸시합니다. NodeShift를 사용하여 애플리케이션을 배포할 때 OpenShift가 수행하는 작업이 바로 이것이기 때문입니다. .

우리는 이 모든 것을 어떻게 알았나요? 에서 공식 Node.js의 공식 버전, 우리는 그것을 복사하고 스스로 수정했습니다.

이제 s2i-web-app 클러스터 작업을 생성해 보겠습니다.

$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/clustertasks/s2i-web-app-task.yaml

이에 대해서는 자세히 분석하지 않고 OUTPUT_DIR 매개변수에만 중점을 둘 것입니다.

params:
      - name: OUTPUT_DIR
        description: The location of the build output directory
        default: build

기본적으로 이 매개변수는 React가 조립된 콘텐츠를 넣는 위치인 build와 동일합니다. 다른 프레임워크는 다른 경로를 사용합니다. 예를 들어 Ember에서는 dist입니다. 첫 번째 클러스터 작업의 출력은 우리가 수집한 HTML, JavaScript 및 CSS가 포함된 이미지입니다.

NGINX를 기반으로 이미지 빌드

두 번째 클러스터 작업에서는 이미 구축한 애플리케이션의 콘텐츠를 사용하여 NGINX 기반 이미지를 구축해야 합니다. 본질적으로 이는 체인 빌드를 살펴본 이전 섹션의 일부입니다.

이를 위해 위와 정확히 동일하게 클러스터 작업 webapp-build-runtime을 생성합니다.

$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/clustertasks/webapp-build-runtime-task.yaml

이러한 클러스터 작업의 코드를 보면 우리가 작업 중인 Git 저장소나 생성 중인 이미지의 이름을 지정하지 않는다는 것을 알 수 있습니다. Git으로 전송할 내용이나 최종 이미지가 출력되어야 하는 특정 이미지만 지정합니다. 이것이 바로 다른 애플리케이션으로 작업할 때 이러한 클러스터 작업을 재사용할 수 있는 이유입니다.

그리고 여기서 우리는 우아하게 다음 지점으로 넘어갑니다.

리소스

따라서 방금 말했듯이 클러스터 작업은 가능한 한 일반적이어야 하므로 입력(Git 저장소) 및 출력(최종 이미지)으로 사용될 리소스를 생성해야 합니다. 우리에게 필요한 첫 번째 리소스는 다음과 같이 애플리케이션이 있는 Git입니다.

# This resource is the location of the git repo with the web application source
apiVersion: tekton.dev/v1alpha1
kind: PipelineResource
metadata:
  name: web-application-repo
spec:
  type: git
  params:
    - name: url
      value: https://github.com/nodeshift-starters/react-pipeline-example
    - name: revision
      value: master

여기서 PipelineResource는 git 유형입니다. params 섹션의 url 키는 특정 저장소를 가리키고 마스터 브랜치를 지정합니다(선택 사항이지만 완전성을 위해 작성합니다).

이제 s2i-web-app 작업의 결과가 저장될 이미지에 대한 리소스를 생성해야 합니다. 이는 다음과 같이 수행됩니다.

# This resource is the result of running "npm run build",  the resulting built files will be located in /opt/app-root/output
apiVersion: tekton.dev/v1alpha1
kind: PipelineResource
metadata:
  name: built-web-application-image
spec:
  type: image
  params:
    - name: url
      value: image-registry.openshift-image-registry.svc:5000/webapp-pipeline/built-web-application:latest

여기서 PipelineResource는 이미지 유형이고 url 매개변수의 값은 내부 OpenShift 이미지 레지스트리, 특히 webapp-pipeline 네임스페이스에 있는 레지스트리를 가리킵니다. 다른 네임스페이스를 사용하는 경우 이 설정을 변경하는 것을 잊지 마세요.

마지막으로 필요한 마지막 리소스도 이미지 유형이 될 것이며 이것이 배포 중에 사용될 최종 NGINX 이미지가 될 것입니다.

# This resource is the image that will be just the static html, css, js files being run with nginx
apiVersion: tekton.dev/v1alpha1
kind: PipelineResource
metadata:
  name: runtime-web-application-image
spec:
  type: image
  params:
    - name: url
      value: image-registry.openshift-image-registry.svc:5000/webapp-pipeline/runtime-web-application:latest

다시 한번 말씀드리지만, 이 리소스는 webapp-pipeline 네임스페이스의 내부 OpenShift 레지스트리에 이미지를 저장합니다.

이러한 모든 리소스를 한 번에 생성하려면 create 명령을 사용합니다.

$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/resources/resource.yaml

다음과 같이 리소스가 생성되었는지 확인할 수 있습니다.

$ tkn resource ls

컨베이어 파이프라인

이제 필요한 구성 요소가 모두 준비되었으므로 다음 명령을 사용하여 파이프라인을 생성해 보겠습니다.

$ oc create -f https://raw.githubusercontent.com/nodeshift/webapp-pipeline-tutorial/master/pipelines/build-and-deploy-react.yaml

하지만 이 명령을 실행하기 전에 이러한 구성 요소를 살펴보겠습니다. 첫 번째는 이름입니다.

apiVersion: tekton.dev/v1alpha1
kind: Pipeline
metadata:
  name: build-and-deploy-react

그런 다음 사양 섹션에서 이전에 생성한 리소스에 대한 표시를 볼 수 있습니다.

spec:
  resources:
    - name: web-application-repo
      type: git
    - name: built-web-application-image
      type: image
    - name: runtime-web-application-image
      type: image

그런 다음 파이프라인이 완료해야 하는 작업을 생성합니다. 우선, 이미 생성한 s2i-web-app 작업을 실행해야 합니다.

tasks:
    - name: build-web-application
      taskRef:
        name: s2i-web-app
        kind: ClusterTask

이 작업은 입력(gir 리소스) 및 출력(build-web-application-image 리소스) 매개변수를 사용합니다. 또한 자체 서명된 인증서를 사용하므로 TLS를 확인하지 않도록 특수 매개변수를 전달합니다.

resources:
        inputs:
          - name: source
            resource: web-application-repo
        outputs:
          - name: image
            resource: built-web-application-image
      params:
        - name: TLSVERIFY
          value: "false"

다음 작업은 거의 동일합니다. 여기서는 이미 생성한 webapp-build-runtime 클러스터 작업만 호출됩니다.

name: build-runtime-image
    taskRef:
      name: webapp-build-runtime
      kind: ClusterTask

이전 작업과 마찬가지로 리소스를 전달하지만 이제는 build-web-application-image(이전 작업의 출력)입니다. 그리고 출력으로 이미지를 다시 설정합니다. 이 작업은 이전 작업 이후에 실행되어야 하므로 runAfter 필드를 추가합니다.

resources:
        inputs:
          - name: image
            resource: built-web-application-image
        outputs:
          - name: image
            resource: runtime-web-application-image
        params:
        - name: TLSVERIFY
          value: "false"
      runAfter:
        - build-web-application

다음 두 작업은 웹 애플리케이션의 k8s 디렉터리에 있는 서비스, 경로 및 배포 YAML 파일을 사용하고 새 이미지를 생성할 때 이 배포를 업데이트하는 작업을 담당합니다. 우리는 기사의 시작 부분에서 이 두 가지 클러스터 작업을 정의했습니다.

컨베이어 시작

따라서 파이프라인의 모든 부분이 생성되었으며 다음 명령을 사용하여 실행합니다.

$ tkn pipeline start build-and-deploy-react

이 단계에서는 명령줄이 대화형으로 사용되며 각 요청에 대한 응답으로 적절한 리소스를 선택해야 합니다. git 리소스에 대해 web-application-repo를 선택한 다음 첫 번째 이미지 리소스에 대해 build-web-application을 선택합니다. -image, 마지막으로 두 번째 이미지 리소스 –runtime-web-application-image:

? Choose the git resource to use for web-application-repo: web-application-repo (https://github.com/nodeshift-starters/react-pipeline-example)
? Choose the image resource to use for built-web-application-image: built-web-application-image (image-registry.openshift-image-registry.svc:5000/webapp-pipeline/built-web-
application:latest)
? Choose the image resource to use for runtime-web-application-image: runtime-web-application-image (image-registry.openshift-image-registry.svc:5000/webapp-pipeline/runtim
e-web-application:latest)
Pipelinerun started: build-and-deploy-react-run-4xwsr

이제 다음 명령을 사용하여 파이프라인의 상태를 확인해 보겠습니다.

$ tkn pipeline logs -f

파이프라인이 시작되고 애플리케이션이 배포되면 다음 명령을 사용하여 게시된 경로를 요청할 수 있습니다.

$ oc get route react-pipeline-example --template='http://{{.spec.host}}'

더 나은 시각화를 위해 웹 콘솔의 개발자 모드 섹션에서 파이프라인을 볼 수 있습니다. 파이프 라인, 그림과 같이. 1.

그림 1. 실행 중인 파이프라인을 검토합니다.

실행 중인 파이프라인을 클릭하면 그림 2와 같이 추가 세부 정보가 표시됩니다.

쌀. 2. 파이프라인에 대한 추가 정보.

자세한 내용을 확인한 후 보기에서 실행 중인 애플리케이션을 볼 수 있습니다. 토폴로지, 그림 3과 같이.

그림 3. 출시된 포드.

아이콘의 오른쪽 상단에 있는 원을 클릭하면 그림 4와 같이 애플리케이션이 열립니다.

쌀. 4. React 애플리케이션을 실행합니다.

결론

따라서 OpenShift에서 애플리케이션용 개발 서버를 실행하고 이를 로컬 파일 시스템과 동기화하는 방법을 보여주었습니다. 또한 OpenShift Pipelines를 사용하여 체인 빌드 템플릿을 시뮬레이션하는 방법도 살펴보았습니다. 이 기사의 모든 예제 코드를 찾을 수 있습니다. 여기에.

추가 자료(EN)

다가오는 웹 세미나 공지

Red Hat OpenShift Container Platform 및 Kubernetes를 사용한 기본 경험에 관한 일련의 금요일 웹 세미나를 시작합니다.

출처 : habr.com

OpenShift의 최신 애플리케이션, 3부: 개발 환경으로서의 OpenShift 및 OpenShift Pipelines