Serverless 설치

절차

1. 웹 콘솔에서 Operator → OperatorHub 페이지로 이동합니다.
2. 스크롤하거나 키워드로 필터링 상자에 키워드 서버리스를 입력하여 OpenShift Serverless Operator를 찾습니다.
3. Operator에 대한 정보를 검토하고 설치를 클릭합니다.

4. Operator 설치 페이지에서 다음을 수행합니다.

   1. 설치 모드는 클러스터의 모든 네임스페이스(기본값)입니다. 이 모드에서는 클러스터의 모든 네임스페이스를 감시하고 사용할 수 있도록 기본 openshift-serverless 네임스페이스에 Operator를 설치합니다.
   2. 설치된 네임스페이스 는 openshift-serverless 입니다.

   3. Update Channel을 선택합니다.

      • stable 채널을 사용하면 OpenShift Serverless Operator의 안정적인 최신 릴리스를 설치할 수 있습니다. stable 채널이 기본값입니다.
      • 다른 버전을 설치하려면 해당 stable-x.y 채널을 지정합니다(예: stable-1.29 ).
   4. stable 채널을 업데이트 채널로 선택합니다. stable 채널을 사용하면 안정적인 최신 릴리스의 OpenShift Pipelines Operator를 설치할 수 있습니다.
   5. 자동 또는 수동 승인 전략을 선택합니다.
5. 이 OpenShift Container Platform 클러스터에서 선택한 네임스페이스에서 Operator를 사용할 수 있도록 하려면 설치를 클릭합니다.

6. 카탈로그 → Operator 관리 페이지에서 OpenShift Serverless Operator 서브스크립션 설치 및 업그레이드 진행 상황을 모니터링할 수 있습니다.

   1. 수동 승인 전략을 선택한 경우 설치 계획을 검토하고 승인할 때까지 서브스크립션의 업그레이드 상태가 업그레이드 중으로 유지됩니다. 설치 계획 페이지에서 승인한 후 subscription 업그레이드 상태가 최신으로 이동합니다.
   2. 자동 승인 전략을 선택한 경우 업그레이드 상태가 개입 없이 최신 상태로 확인되어야 합니다.

1. 카탈로그 → Operator 관리 페이지로 전환한 후 Operator 서브스크립션 및 설치 계획 탭의 상태에 장애나 오류가 있는지 검사합니다.
2. 워크로드 → Pod 페이지의 openshift-serverless 프로젝트에서 문제를 보고하는 Pod의 로그를 확인하여 추가로 문제를 해결합니다.

절차

1. Namespace,OperatorGroup, Subscription 오브젝트가 포함된 YAML 파일을 생성하여 네임스페이스를 OpenShift Serverless Operator에 등록합니다. 예를 들어 다음 콘텐츠를 사용하여 서버리스-subscription.yaml 파일을 생성합니다.

   서브스크립션 예

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-serverless
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: serverless-operators
     namespace: openshift-serverless
   spec: {}
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable 1
     name: serverless-operator 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   1

   Operator의 채널 이름입니다. stable 채널을 사용하면 안정적인 최신 버전의 OpenShift Serverless Operator를 설치할 수 있습니다. 다른 버전을 설치하려면 해당 stable-x.y 채널을 지정합니다(예: stable-1.29 ).

   2

   등록할 Operator의 이름입니다. OpenShift Serverless Operator의 경우 항상 서버리스-operator 입니다.

   3

   Operator를 제공하는 CatalogSource의 이름입니다. 기본 OperatorHub 카탈로그 소스로 redhat-operators 를 사용합니다.

   4

   CatalogSource의 네임스페이스입니다. 기본 OperatorHub 카탈로그 소스에는 openshift-marketplace를 사용합니다.

2. Subscription 오브젝트를 생성합니다.

   $ oc apply -f serverless-subscription.yaml

절차

1. 명령줄 툴 페이지에서 Knative(kn) CLI를 다운로드합니다. 웹 콘솔의 오른쪽 상단에 있는 아이콘을 클릭하고 목록에서 명령줄 툴을 선택하여 명령줄 툴에 액세스할 수 있습니다.

2. 아카이브의 압축을 풉니다.

   $ tar -xf <file>

3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

4. PATH를 확인하려면 다음을 실행합니다.

   $ echo $PATH

절차

1. Red Hat Subscription Manager에 등록합니다.

   # subscription-manager register

2. 최신 서브스크립션 데이터를 가져옵니다.

   # subscription-manager refresh

3. 등록된 시스템에 서브스크립션을 연결합니다.

   # subscription-manager attach --pool=<pool_id> 1

   1

   활성 OpenShift Container Platform 서브스크립션의 풀 ID

4. Knative(kn) CLI에 필요한 리포지토리를 활성화합니다.

   • Linux (x86_64, amd64)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"

   • Linux on IBM zSystems and IBM® LinuxONE(s390x)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-s390x-rpms"

   • Linux on IBM Power (ppc64le)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-ppc64le-rpms"

5. 패키지 관리자를 사용하여 Knative(kn) CLI를 RPM으로 설치합니다.

   yum 명령 예

   # yum install openshift-serverless-clients

절차

1. DNF 패키지 관리자의 versionlock 플러그인을 설치합니다.

   # dnf install 'dnf-command(versionlock)'

2. 다음을 실행하여 kn 버전을 잠급니다.

   # dnf versionlock add --raw 'openshift-serverless-clients-1.7.*'

   이 명령은 OpenShift Serverless 1.29 릴리스 시 유지 관리 단계에 있는 Knative 1.7 기반 버전으로 kn 을 잠급니다.

절차

1. 업그레이드된 패키지를 사용할 수 있는지 확인합니다.

   # dnf search --showduplicates openshift-serverless-clients

2. kn 의 버전 잠금을 제거합니다.

1. kn 을 새 버전으로 잠급니다.

1. 사용 가능한 새 버전으로 업그레이드:

   # dnf install --upgrade openshift-serverless-clients

절차

1. 관련 Knative(kn) CLI tar.gz 아카이브를 다운로드합니다.

   • Linux (x86_64, amd64)
   • Linux on IBM zSystems and IBM® LinuxONE(s390x)
   • Linux on IBM Power (ppc64le)

   Serverless 클라이언트 다운로드 미러에서 해당 버전의 해당 디렉터리로 이동하여 kn 버전을 다운로드할 수도 있습니다.

2. 아카이브의 압축을 풉니다.

   $ tar -xf <filename>

3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

4. PATH를 확인하려면 다음을 실행합니다.

   $ echo $PATH

절차

1. Knative (kn) CLI tar.gz 아카이브를 다운로드합니다.

   Serverless 클라이언트 다운로드 미러에서 해당 버전의 해당 디렉터리로 이동하여 kn 버전을 다운로드할 수도 있습니다.

2. 아카이브의 압축을 풀고 추출합니다.
3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

4. PATH를 확인하려면 터미널 창을 열고 다음을 실행합니다.

   $ echo $PATH

절차

1. Knative (kn) CLI ZIP 아카이브를 다운로드합니다.

   Serverless 클라이언트 다운로드 미러에서 해당 버전의 해당 디렉터리로 이동하여 kn 버전을 다운로드할 수도 있습니다.

2. ZIP 프로그램으로 아카이브의 압축을 풉니다.
3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

4. PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.

   C:\> path

절차

1. OpenShift Container Platform 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator로 이동합니다.
2. 페이지 상단에 있는 프로젝트 드롭다운이 Project: knative-serving으로 설정되어 있는지 확인합니다.
3. OpenShift Serverless Operator의 제공되는 API 목록에서 Knative Serving을 클릭하여 Knative Serving 탭으로 이동합니다.
4. Knative Serving 생성을 클릭합니다.

5. Knative Serving 생성 페이지에서 생성을 클릭하면 기본 설정을 사용하여 Knative Serving을 설치할 수 있습니다.

   제공된 양식을 사용하여 KnativeServing 오브젝트를 편집하거나 YAML을 편집하여 Knative Serving 설치에 대한 설정을 수정할 수도 있습니다.

   • 해당 양식은 KnativeServing 오브젝트 생성을 완전히 제어할 필요가 없는 단순한 구성에 사용하는 것이 좋습니다.

   • KnativeServing 오브젝트 생성을 완전히 제어해야 하는 복잡한 구성의 경우 YAML을 편집하는 것이 좋습니다. Knative Serving 생성 페이지의 오른쪽 상단에 있는 YAML 편집 링크를 클릭하여 YAML에 액세스할 수 있습니다.

     양식을 작성하거나 YAML을 수정한 후 생성을 클릭합니다.

     참고

     KnativeServing 사용자 정의 리소스 정의의 구성 옵션에 대한 자세한 내용은 고급 설치 구성 옵션 설명서를 참조하십시오.

6. Knative Serving이 설치되면 KnativeServing 오브젝트가 생성되고 Knative Serving 탭으로 자동으로 이동합니다. 리소스 목록에 knative-serving 사용자 정의 리소스가 표시됩니다.

검증

1. Knative Serving 탭에서 knative-serving 사용자 정의 리소스를 클릭합니다.

2. 그러면 Knative Serving 개요 페이지로 자동으로 이동합니다.

   
3. 조건 목록을 보려면 아래로 스크롤합니다.

4. 예제 이미지에 표시된 대로 상태가 True인 조건 목록이 표시되어야 합니다.

   
   참고

   Knative Serving 리소스를 생성하는 데 몇 초가 걸릴 수 있습니다. 리소스 탭에서 해당 상태를 확인할 수 있습니다.

5. 조건이 알 수 없음 또는 False 상태인 경우 몇 분 정도 기다렸다가 리소스가 생성된 것을 확인한 후 다시 확인하십시오.

절차

1. serving.yaml이라는 파일을 생성하고 다음 예제 YAML을 이 파일에 복사합니다.

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
       name: knative-serving
       namespace: knative-serving

2. serving.yaml 파일을 적용합니다.

   $ oc apply -f serving.yaml

검증

1. 설치가 완료되었는지 확인하려면 다음 명령을 입력합니다.

   $ oc get knativeserving.operator.knative.dev/knative-serving -n knative-serving --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   출력 예

   DependenciesInstalled=True
   DeploymentsAvailable=True
   InstallSucceeded=True
   Ready=True

   참고

   Knative Serving 리소스를 생성하는 데 몇 초가 걸릴 수 있습니다.

   조건이 알 수 없음 또는 False 상태인 경우 몇 분 정도 기다렸다가 리소스가 생성된 것을 확인한 후 다시 확인하십시오.

2. Knative Serving 리소스가 생성되었는지 확인합니다.

   $ oc get pods -n knative-serving

   출력 예

   NAME                                                        READY   STATUS      RESTARTS   AGE
   activator-67ddf8c9d7-p7rm5                                  2/2     Running     0          4m
   activator-67ddf8c9d7-q84fz                                  2/2     Running     0          4m
   autoscaler-5d87bc6dbf-6nqc6                                 2/2     Running     0          3m59s
   autoscaler-5d87bc6dbf-h64rl                                 2/2     Running     0          3m59s
   autoscaler-hpa-77f85f5cc4-lrts7                             2/2     Running     0          3m57s
   autoscaler-hpa-77f85f5cc4-zx7hl                             2/2     Running     0          3m56s
   controller-5cfc7cb8db-nlccl                                 2/2     Running     0          3m50s
   controller-5cfc7cb8db-rmv7r                                 2/2     Running     0          3m18s
   domain-mapping-86d84bb6b4-r746m                             2/2     Running     0          3m58s
   domain-mapping-86d84bb6b4-v7nh8                             2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-bkcnj                      2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-fff68                      2/2     Running     0          3m58s
   storage-version-migration-serving-serving-0.26.0--1-6qlkb   0/1     Completed   0          3m56s
   webhook-5fb774f8d8-6bqrt                                    2/2     Running     0          3m57s
   webhook-5fb774f8d8-b8lt5                                    2/2     Running     0          3m57s

3. 필요한 네트워킹 구성 요소가 자동으로 생성된 knative-serving-ingress 네임스페이스에 설치되었는지 확인합니다.

   $ oc get pods -n knative-serving-ingress

   출력 예

   NAME                                      READY   STATUS    RESTARTS   AGE
   net-kourier-controller-7d4b6c5d95-62mkf   1/1     Running   0          76s
   net-kourier-controller-7d4b6c5d95-qmgm2   1/1     Running   0          76s
   3scale-kourier-gateway-6688b49568-987qz   1/1     Running   0          75s
   3scale-kourier-gateway-6688b49568-b5tnp   1/1     Running   0          75s

절차

1. OpenShift Container Platform 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator로 이동합니다.
2. 페이지 상단에 있는 프로젝트 드롭다운이 Project: knative-eventing으로 설정되어 있는지 확인합니다.
3. OpenShift Serverless Operator의 제공되는 API 목록에서 Knative Eventing을 클릭하여 Knative Eventing 탭으로 이동합니다.
4. Knative Eventing 생성을 클릭합니다.

5. Knative Eventing 생성 페이지에서 제공된 기본 양식을 사용하거나 YAML을 편집하여 KnativeEventing 오브젝트를 구성하도록 선택할 수 있습니다.

   • 해당 양식은 KnativeEventing 오브젝트 생성을 완전히 제어할 필요가 없는 단순한 구성에 사용하는 것이 좋습니다.

     선택 사항입니다. 양식을 사용하여 KnativeEventing 오브젝트를 구성하는 경우 Knative Eventing 배포에 구현하려는 변경을 수행합니다.

6. 생성을 클릭합니다.

   • KnativeEventing 오브젝트 생성을 완전히 제어해야 하는 복잡한 구성의 경우 YAML을 편집하는 것이 좋습니다. Knative Eventing 생성 페이지의 오른쪽 상단에 있는 YAML 편집 링크를 클릭하여 YAML에 액세스할 수 있습니다.

     선택 사항입니다. YAML을 편집하여 KnativeEventing 오브젝트를 구성하는 경우 YAML에 Knative Eventing 배포에 구현하려는 변경을 수행합니다.

7. 생성을 클릭합니다.
8. Knative Eventing을 설치하면 KnativeEventing 오브젝트가 생성되고 Knative Eventing 탭으로 자동으로 이동합니다. 리소스 목록에 knative-eventing 사용자 정의 리소스가 표시됩니다.

검증

1. Knative Eventing 탭에서 knative-eventing 사용자 정의 리소스를 클릭합니다.

2. 그러면 자동으로 Knative Eventing 개요 페이지로 이동합니다.

   
3. 조건 목록을 보려면 아래로 스크롤합니다.

4. 예제 이미지에 표시된 대로 상태가 True인 조건 목록이 표시되어야 합니다.

   
   참고

   Knative Eventing 리소스를 생성하는 데 몇 초가 걸릴 수 있습니다. 리소스 탭에서 해당 상태를 확인할 수 있습니다.

5. 조건이 알 수 없음 또는 False 상태인 경우 몇 분 정도 기다렸다가 리소스가 생성된 것을 확인한 후 다시 확인하십시오.

절차

1. eventing.yaml이라는 파일을 생성합니다.

2. 다음 샘플 YAML을 eventing.yaml에 복사합니다.

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing

3. 선택 사항입니다. Knative Eventing 배포를 위해 구현하려는 YAML을 변경합니다.

4. 다음을 입력하여 eventing.yaml 파일을 적용합니다.

   $ oc apply -f eventing.yaml

검증

1. 다음 명령을 입력하고 출력을 관찰하여 설치가 완료되었는지 확인합니다.

   $ oc get knativeeventing.operator.knative.dev/knative-eventing \
     -n knative-eventing \
     --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   출력 예

   InstallSucceeded=True
   Ready=True

   참고

   Knative Eventing 리소스를 생성하는 데 몇 초가 걸릴 수 있습니다.

2. 조건이 알 수 없음 또는 False 상태인 경우 몇 분 정도 기다렸다가 리소스가 생성된 것을 확인한 후 다시 확인하십시오.

3. 다음을 입력하여 Knative Eventing 리소스가 생성되었는지 확인합니다.

   $ oc get pods -n knative-eventing

   출력 예

   NAME                                   READY   STATUS    RESTARTS   AGE
   broker-controller-58765d9d49-g9zp6     1/1     Running   0          7m21s
   eventing-controller-65fdd66b54-jw7bh   1/1     Running   0          7m31s
   eventing-webhook-57fd74b5bd-kvhlz      1/1     Running   0          7m31s
   imc-controller-5b75d458fc-ptvm2        1/1     Running   0          7m19s
   imc-dispatcher-64f6d5fccb-kkc4c        1/1     Running   0          7m18s

검증

1. Knative Kafka 탭에서 knative-kafka 리소스를 클릭합니다. 그러면 자동으로 Knative Kafka 개요 페이지로 이동합니다.

2. 리소스에 대한 조건 목록을 확인하고 상태가 True인지 확인합니다.

   

   조건 상태가 알 수 없음 또는 False인 경우 몇 분 정도 기다린 후 페이지를 새로 고칩니다.

3. Apache Kafka 리소스의 Knative 브로커가 생성되었는지 확인합니다.

   $ oc get pods -n knative-eventing

   출력 예

   NAME                                        READY   STATUS    RESTARTS   AGE
   kafka-broker-dispatcher-7769fbbcbb-xgffn    2/2     Running   0          44s
   kafka-broker-receiver-5fb56f7656-fhq8d      2/2     Running   0          44s
   kafka-channel-dispatcher-84fd6cb7f9-k2tjv   2/2     Running   0          44s
   kafka-channel-receiver-9b7f795d5-c76xr      2/2     Running   0          44s
   kafka-controller-6f95659bf6-trd6r           2/2     Running   0          44s
   kafka-source-dispatcher-6bf98bdfff-8bcsn    2/2     Running   0          44s
   kafka-webhook-eventing-68dc95d54b-825xs     2/2     Running   0          44s

절차

1. ${XDG_RUNTIME_DIR}/podman/podman.sock 의 UNIX 소켓에서 Docker API를 제공하는 Podman 서비스를 시작합니다.

   $ systemctl start --user podman.socket

   참고

   대부분의 시스템에서 이 소켓은 /run/user/$(id -u)/podman/podman.sock에 있습니다.

2. 기능을 구축하는 데 사용되는 환경 변수를 설정합니다.

   $ export DOCKER_HOST="unix://${XDG_RUNTIME_DIR}/podman/podman.sock"

3. 함수 프로젝트 디렉터리 내에서 -v 플래그를 사용하여 빌드 명령을 실행하여 자세한 출력을 확인합니다. 로컬 UNIX 소켓에 대한 연결이 표시됩니다.

   $ kn func build -v

절차

1. Podman 시스템을 생성합니다.

   $ podman machine init --memory=8192 --cpus=2 --disk-size=20

2. UNIX 소켓에서 Docker API를 제공하는 Podman 시스템을 시작합니다.

   $ podman machine start
   Starting machine "podman-machine-default"
   Waiting for VM ...
   Mounting volume... /Users/myuser:/Users/user
   
   [...truncated output...]
   
   You can still connect Docker API clients by setting DOCKER_HOST using the
   following command in your terminal session:
   
   	export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'
   
   Machine "podman-machine-default" started successfully

   참고

   대부분의 macOS 시스템에서 이 소켓은 /Users/myuser/.local/share/containers/podman/podman-machine-machine-default/podman.sock 에 있습니다.

3. 기능을 구축하는 데 사용되는 환경 변수를 설정합니다.

   $ export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'

4. 함수 프로젝트 디렉터리 내에서 -v 플래그를 사용하여 빌드 명령을 실행하여 자세한 출력을 확인합니다. 로컬 UNIX 소켓에 대한 연결이 표시됩니다.

   $ kn func build -v

절차

1. OpenShift Serverless 릴리스 노트에서 검색하여 원래 설치된 OpenShift Serverless Operator 버전을 확인합니다.

   예를 들어 업그레이드 시도 중 오류 메시지에 다음 문자열이 포함될 수 있습니다.

   The installed KnativeServing version is v1.5.0.

   이 예에서 KnativeServing MAJOR.MINOR 버전은 1.5 입니다. 이 버전은 OpenShift Serverless 1.26: OpenShift Serverless의 릴리스 노트에서 현재 Knative Serving 1.5를 사용합니다.

2. OpenShift Serverless Operator 및 모든 설치 계획을 설치 제거합니다.

3. 첫 번째 단계에서 검색한 OpenShift Serverless Operator 버전을 수동으로 설치합니다. 설치하려면 다음 예와 같이 먼저 서버리스-subscription.yaml 파일을 생성합니다.

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable
     name: serverless-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Manual
     startingCSV: serverless-operator.v1.26.0

4. 그런 다음 다음 명령을 실행하여 서브스크립션을 설치합니다.

   $ oc apply -f serverless-subscription.yaml

5. 표시되는 대로 업그레이드 설치 계획을 수동으로 승인합니다.