3.3. Knative CLI 설치

Knative(kn) CLI에는 자체 로그인 메커니즘이 없습니다. 클러스터에 로그인하려면 OpenShift CLI(oc)를 설치하고 oc login 명령을 사용해야 합니다. CLI의 설치 옵션은 운영 체제에 따라 다를 수 있습니다.

운영 체제에 대한 OpenShift CLI(oc)를 설치하고 oc 로 로그인하는 방법에 대한 자세한 내용은 OpenShift CLI 시작하기 설명서를 참조하십시오.

OpenShift Serverless는 Knative(kn) CLI를 사용하여 설치할 수 없습니다. 클러스터 관리자는 OpenShift Serverless Operator 설치 설명서에 설명된 대로 OpenShift Serverless Operator 를 설치하고 Knative 구성 요소를 설정해야 합니다.

중요

최신 OpenShift Serverless 릴리스에서 이전 버전의 Knative(kn) CLI를 사용하려는 경우 API를 찾을 수 없으며 오류가 발생합니다.

예를 들어 Knative Serving 및 Knative Eventing API의 1.3 버전을 사용하는 1.24.0 OpenShift Serverless 릴리스에서 버전 1.2를 사용하는 Knative(kn) CLI의 1.23.0 릴리스를 사용하는 경우 이전 1.2 API 버전을 계속 찾기 때문에 CLI가 작동하지 않습니다.

문제를 방지하려면 OpenShift Serverless 릴리스에 최신 Knative(kn) CLI 버전을 사용하고 있는지 확인합니다.

3.3.1. OpenShift Container Platform 웹 콘솔을 통한 Knative CLI 설치

OpenShift Container Platform 웹 콘솔을 사용하면 간소화되고 직관적인 사용자 인터페이스를 제공하여 Knative(kn) CLI를 설치할 수 있습니다. OpenShift Serverless Operator가 설치되면 OpenShift Container Platform 웹 콘솔의 명령줄 툴 페이지에 Linux (amd64, s390x, ppc64le), macOS 또는 Windows에 대한 Knative (kn) CLI를 다운로드할 수 있는 링크가 표시됩니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 로그인했습니다.

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

    중요

    libc를 사용할 수 없는 경우 CLI 명령을 실행할 때 다음과 같은 오류가 표시될 수 있습니다. 

    $ kn: No such file or directory
  • 이 절차에 대한 확인 단계를 사용하려면 OpenShift (oc) CLI를 설치해야 합니다.

절차

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

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

    $ tar -xf <file>
  3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

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

    $ echo $PATH

검증

  • 다음 명령을 실행하여 올바른 Knative CLI 리소스 및 경로가 생성되었는지 확인합니다. 

    $ oc get ConsoleCLIDownload

    출력 예

    NAME                  DISPLAY NAME                                             AGE
kn                    kn - OpenShift Serverless Command Line Interface (CLI)   2022-09-20T08:41:18Z
oc-cli-downloads      oc - OpenShift Command Line Interface (CLI)              2022-09-20T08:00:20Z

    $ oc get route -n openshift-serverless

    출력 예

    NAME   HOST/PORT                                  PATH   SERVICES                      PORT       TERMINATION     WILDCARD
kn     kn-openshift-serverless.apps.example.com          knative-openshift-metrics-3   http-cli   edge/Redirect   None

3.3.2. RPM 패키지 관리자를 사용하여 Linux용 Knative CLI 설치

RHEL(Red Hat Enterprise Linux)의 경우 yum 또는 dnf 와 같은 패키지 관리자를 사용하여 Knative(kn) CLI를 RPM으로 설치할 수 있습니다. 이를 통해 Knative CLI 버전을 시스템에서 자동으로 관리할 수 있습니다. 예를 들어 dnf 업그레이드와 같은 명령을 사용하면 새 버전을 사용할 수 있는 경우 kn 을 포함한 모든 패키지가 업그레이드됩니다.

사전 요구 사항

  • Red Hat 계정에 활성 OpenShift Container Platform 서브스크립션이 있어야 합니다.

절차

  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

3.3.3. Linux의 Knative CLI 설치

RPM 또는 다른 패키지 관리자가 설치되어 있지 않은 Linux 배포를 사용하는 경우 Knative(kn) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 tar.gz 아카이브를 다운로드하여 압축 해제하고 PATH 의 디렉터리에 바이너리를 추가해야 합니다.

사전 요구 사항

  • RHEL 또는 Fedora를 사용하지 않는 경우 libc 가 라이브러리 경로의 디렉터리에 설치되어 있는지 확인합니다.

    중요

    libc를 사용할 수 없는 경우 CLI 명령을 실행할 때 다음과 같은 오류가 표시될 수 있습니다. 

    $ kn: No such file or directory

절차

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

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

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

    $ tar -xf <filename>
  3. kn 바이너리를 PATH의 디렉터리로 이동합니다.

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

    $ echo $PATH

3.3.4. macOS용 Knative CLI 설치

macOS를 사용하는 경우 Knative(kn) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 tar.gz 아카이브를 다운로드하여 압축 해제하고 PATH 의 디렉터리에 바이너리를 추가해야 합니다.

절차

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

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

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

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

    $ echo $PATH

3.3.5. Windows용 Knative CLI 설치

Windows를 사용하는 경우 Knative(kn) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 ZIP 아카이브를 다운로드하여 압축 해제하고 PATH 의 디렉터리에 바이너리를 추가해야 합니다.

절차

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

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

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

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

    C:\> path