사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.

절차

• Knative 서비스를 생성합니다.

  $ kn service create <service-name> --image <image> --tag <tag-value>

  다음과 같습니다.

  • --image 는 애플리케이션의 이미지 URI입니다.

  • --tag 는 서비스로 생성된 초기 버전에 태그를 추가하는 데 사용할 수 있는 선택적 플래그입니다.

    명령 예

    $ kn service create event-display \
        --image quay.io/openshift-knative/knative-eventing-sources-event-display:latest

    출력 예

    Creating service 'event-display' in namespace 'default':
    
      0.271s The Route is still working to reflect the latest desired specification.
      0.580s Configuration "event-display" is waiting for a Revision to become ready.
      3.857s ...
      3.861s Ingress has not yet been reconciled.
      4.270s Ready to serve.
    
    Service 'event-display' created with latest revision 'event-display-bxshg-1' and URL:
    http://event-display-default.apps-crc.testing

명령 예

• 새 환경 변수를 추가하여 서비스를 업데이트합니다.

  $ kn service update <service_name> --env <key>=<value>

• 새 포트를 추가하여 서비스를 업데이트합니다.

  $ kn service update <service_name> --port 80

• 새 요청 및 제한 매개변수를 추가하여 서비스를 업데이트합니다.

  $ kn service update <service_name> --request cpu=500m --limit memory=1024Mi --limit cpu=1000m

• latest 태그를 개정 버전에 할당합니다.

  $ kn service update <service_name> --tag <revision_name>=latest

• 서비스의 최신 READY 버전에 대한 태그를 testing에서 staging으로 업데이트합니다.

  $ kn service update <service_name> --untag testing --tag @latest=staging

• 트래픽의 10%를 수신하는 버전에 test 태그를 추가하고 나머지 트래픽을 서비스의 최신 READY 버전으로 전송합니다.

  $ kn service update <service_name> --tag <revision_name>=test --traffic test=10,@latest=90

명령 예

• 서비스를 생성합니다.

  $ kn service apply <service_name> --image <image>

• 서비스에 환경 변수를 추가합니다.

  $ kn service apply <service_name> --image <image> --env <key>=<value>

• JSON 또는 YAML 파일에서 서비스 선언을 읽습니다.

  $ kn service apply <service_name> -f <filename>

명령 예

• 서비스를 설명합니다.

  $ kn service describe --verbose <service_name>

  --verbose 플래그는 선택 사항이지만 자세한 설명을 제공하기 위해 포함할 수 있습니다. 일반 출력과 자세한 출력의 차이점은 다음 예에 표시됩니다.

  --verbose 플래그를 사용하지 않는 출력 예

  Name:       hello
  Namespace:  default
  Age:        2m
  URL:        http://hello-default.apps.ocp.example.com
  
  Revisions:
    100%  @latest (hello-00001) [1] (2m)
          Image:  docker.io/openshift/hello-openshift (pinned to aaea76)
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   1m
    ++ ConfigurationsReady     1m
    ++ RoutesReady             1m

  --verbose 플래그를 사용하는 출력 예

  Name:         hello
  Namespace:    default
  Annotations:  serving.knative.dev/creator=system:admin
                serving.knative.dev/lastModifier=system:admin
  Age:          3m
  URL:          http://hello-default.apps.ocp.example.com
  Cluster:      http://hello.default.svc.cluster.local
  
  Revisions:
    100%  @latest (hello-00001) [1] (3m)
          Image:  docker.io/openshift/hello-openshift (pinned to aaea76)
          Env:    RESPONSE=Hello Serverless!
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   3m
    ++ ConfigurationsReady     3m
    ++ RoutesReady             3m

• YAML 형식으로 서비스를 설명합니다.

  $ kn service describe <service_name> -o yaml

• JSON 형식으로 서비스를 설명합니다.

  $ kn service describe <service_name> -o json

• 서비스 URL만 인쇄합니다.

  $ kn service describe <service_name> -o url

• 클러스터 변경에 사용하기 전에 설명자 파일을 수동으로 수정할 수 있습니다.
• 버전 관리 시스템에서 서비스의 설명자 파일을 로컬로 추적할 수 있습니다. 이를 통해 CI(지속적 통합) 파이프라인, 개발 환경 또는 데모와 같이 대상 클러스터 이외의 위치에서 설명자 파일을 재사용할 수 있습니다.
• 생성된 설명자 파일을 검사하여 Knative 서비스에 대해 확인할 수 있습니다. 특히 결과 서비스가 kn 명령에 전달된 다양한 인수에 영향을 받는 방법을 확인할 수 있습니다.

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.

• 이미지에서 컨테이너를 추가하고 표준 출력에 출력합니다.

  $ kn container add <container_name> --image <image_uri>

  명령 예

  $ kn container add sidecar --image docker.io/example/sidecar

  출력 예

  containers:
  - image: docker.io/example/sidecar
    name: sidecar
    resources: {}

• 두 개의 kn 컨테이너 추가 명령을 함께 연결한 다음 kn service create 명령에 전달하여 두 개의 컨테이너가 있는 Knative 서비스를 생성합니다.

  $ kn container add <first_container_name> --image <image_uri> | \
  kn container add <second_container_name> --image <image_uri> | \
  kn service create <service_name> --image <image_uri> --extra-containers -

  --extra-containers - kn 이 YAML 파일 대신 파이프 입력을 읽는 특수한 사례를 지정합니다.

  명령 예

  $ kn container add sidecar --image docker.io/example/sidecar:first | \
  kn container add second --image docker.io/example/sidecar:second | \
  kn service create my-service --image docker.io/example/my-app:latest --extra-containers -

  --extra-containers 플래그는 YAML 파일의 경로도 허용할 수 있습니다.

  $ kn service create <service_name> --image <image_uri> --extra-containers <filename>

  명령 예

  $ kn service create my-service --image docker.io/example/my-app:latest --extra-containers my-extra-containers.yaml

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.

• Knative 서비스 또는 경로를 생성했으며 CR에 매핑할 사용자 정의 도메인을 제어할 수 있습니다.

  참고

  사용자 정의 도메인에서 OpenShift Container Platform 클러스터의 DNS를 가리켜야 합니다.

• Knative(kn) CLI가 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.

절차

• 현재 네임스페이스의 CR에 도메인을 매핑합니다.

  $ kn domain create <domain_mapping_name> --ref <target_name>

  명령 예

  $ kn domain create example.com --ref example-service

  --ref 플래그는 도메인 매핑을 위해 주소 지정 가능한 대상 CR을 지정합니다.

  --ref 플래그를 사용할 때 접두사가 지정되어 있지 않은 경우 대상이 현재 네임스페이스의 Knative 서비스라고 가정합니다.

• 지정된 네임스페이스의 Knative 서비스에 도메인을 매핑합니다.

  $ kn domain create <domain_mapping_name> --ref <ksvc:service_name:service_namespace>

  명령 예

  $ kn domain create example.com --ref ksvc:example-service:example-namespace

• 도메인을 Knative 경로에 매핑합니다.

  $ kn domain create <domain_mapping_name> --ref <kroute:route_name>

  명령 예

  $ kn domain create example.com --ref kroute:example-route

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• 하나 이상의 DomainMapping CR을 생성했습니다.
• Knative(kn) CLI 툴이 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.

절차

• 기존 DomainMapping CR을 나열합니다.

  $ kn domain list -n <domain_mapping_namespace>

• 기존 DomainMapping CR 정보를 표시합니다.

  $ kn domain describe <domain_mapping_name>

• 새 대상을 참조하도록 DomainMapping CR을 업데이트합니다.

  $ kn domain update --ref <target>

• DomainMapping CR을 삭제합니다.

  $ kn domain delete <domain_mapping_name>

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Eventing이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Eventing이 클러스터에 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.
• OpenShift CLI(oc)가 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.

사전 요구 사항

• OpenShift Serverless Operator, Knative Serving 및 Knative Eventing이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.
• 선택 사항: 이 절차에 대한 확인 단계를 사용하려면 OpenShift CLI(oc)를 설치합니다.

ping 소스 삭제

• ping 소스를 삭제합니다.

  $ kn delete pingsources.sources.knative.dev <ping_source_name>

사전 요구 사항

• OpenShift Serverless Operator, Knative Eventing, Knative Serving, KnativeKafka 사용자 정의 리소스(CR가 클러스터에 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.
• 가져오려는 Kafka 메시지를 생성하는 Red Hat AMQ Streams(Kafka) 클러스터에 액세스할 수 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.
• 선택 사항: 이 절차의 확인 단계를 사용하려면 OpenShift CLI(oc)를 설치했습니다.

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.

절차

• 함수 프로젝트를 생성합니다.

  $ kn func create -r <repository> -l <runtime> -t <template> <path>

  • 허용되는 런타임 값에는 quarkus,node,typescript,go,python,springboot, rust 가 포함됩니다.

  • 허용되는 템플릿 값에는 http 및 cloudevents 가 포함됩니다.

    명령 예

    $ kn func create -l typescript -t cloudevents examplefunc

    출력 예

    Created typescript function in /home/user/demo/examplefunc

  • 또는 사용자 지정 템플릿이 포함된 리포지토리를 지정할 수 있습니다.

    명령 예

    $ kn func create -r https://github.com/boson-project/templates/ -l node -t hello-world examplefunc

    출력 예

    Created node function in /home/user/demo/examplefunc

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.
• 배포하려는 함수를 이미 생성하고 초기화해야 합니다.

절차

• 함수를 배포합니다.

  $ kn func deploy [-n <namespace> -p <path> -i <image>]

  출력 예

  Function deployed at: http://func.example.com

  • namespace를 지정하지 않으면 함수가 현재 네임스페이스에 배포됩니다.
  • 이 함수는 path를 지정하지 않는 한 현재 디렉터리에서 배포됩니다.
  • Knative 서비스 이름은 프로젝트 이름에서 파생되며 이 명령을 사용하여 변경할 수 없습니다.

절차

• 기존 함수를 나열합니다.

  $ kn func list [-n <namespace> -p <path>]

  출력 예

  NAME           NAMESPACE  RUNTIME  URL                                                                                      READY
  example-function  default    node     http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com  True

• Knative 서비스로 배포된 함수를 나열합니다.

  $ kn service list -n <namespace>

  출력 예

  NAME            URL                                                                                       LATEST                AGE   CONDITIONS   READY   REASON
  example-function   http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com   example-function-gzl4c   16m   3 OK / 3     True

절차

• 함수를 설명합니다.

  $ kn func info [-f <format> -n <namespace> -p <path>]

  명령 예

  $ kn func info -p function/example-function

  출력 예

  Function name:
    example-function
  Function is built in image:
    docker.io/user/example-function:latest
  Function is deployed as Knative Service:
    example-function
  Function is deployed in namespace:
    default
  Routes:
    http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com

사전 요구 사항

• OpenShift Serverless Operator 및 Knative Serving이 클러스터에 설치되어 있습니다.
• Knative(kn) CLI가 설치되어 있습니다.
• 프로젝트를 생성했거나 OpenShift Container Platform에서 애플리케이션 및 기타 워크로드를 생성하는 데 적절한 역할 및 권한이 있는 프로젝트에 액세스할 수 있습니다.
• 호출하려는 함수를 이미 배포해야 합니다.

절차

• 함수를 호출합니다.

  $ kn func invoke

  • kn func invoke 명령은 현재 실행 중인 로컬 컨테이너 이미지가 있거나 클러스터에 배포된 함수가 있는 경우에만 작동합니다.
  • kn func invoke 명령은 기본적으로 로컬 디렉터리에서 실행되며 이 디렉터리는 함수 프로젝트라고 가정합니다.

절차

• 함수를 삭제합니다.

  $ kn func delete [<function_name> -n <namespace> -p <path>]

  • 삭제할 함수의 이름 또는 경로가 지정되지 않은 경우 현재 디렉터리에서 func.yaml 파일을 검색하고 삭제할 함수를 결정합니다.
  • 네임스페이스를 지정하지 않으면 기본값은 func.yaml 파일의 namespace 값으로 설정됩니다.