4장. Knative CLI
4.1. Knative CLI 설치
Knative(kn
) CLI에는 자체 로그인 메커니즘이 없습니다. 클러스터에 로그인하려면 OpenShift CLI(oc
)를 설치하고 oc login
명령을 사용해야 합니다. CLI의 설치 옵션은 운영 체제에 따라 다를 수 있습니다.
운영 체제에 oc
CLI를 설치하는 방법 및 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 버전을 사용하고 있는지 확인합니다.
4.1.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를 설치해야 합니다.
절차
-
명령줄 툴 페이지에서 Knative(
kn
) CLI를 다운로드합니다. 웹 콘솔의 오른쪽 상단에 있는 아이콘을 클릭하고 목록에서 명령줄 툴 을 선택하여 명령줄 툴 에 액세스할 수 있습니다. 아카이브의 압축을 풉니다.
$ tar -xf <file>
-
kn
바이너리를PATH
의 디렉터리로 이동합니다. 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
4.1.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 서브스크립션이 있어야 합니다.
절차
Red Hat Subscription Manager에 등록합니다.
# subscription-manager register
최신 서브스크립션 데이터를 가져옵니다.
# subscription-manager refresh
서브스크립션을 등록된 시스템에 연결합니다.
# subscription-manager attach --pool=<pool_id> 1
- 1
- 활성 OpenShift Container Platform 서브스크립션의 풀 ID
Knative(
kn
) CLI에 필요한 리포지토리를 활성화합니다.Linux (x86_64, amd64)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"
Linux on IBM Z 및 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"
패키지 관리자를 사용하여 Knative(
kn
) CLI를 RPM으로 설치합니다.yum
명령 예# yum install openshift-serverless-clients
4.1.3. Linux의 Knative CLI 설치
RPM 또는 다른 패키지 관리자가 설치되지 않은 Linux 배포를 사용하는 경우 Knative(kn
) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 tar.gz
아카이브를 다운로드하여 압축을 풀고 PATH
의 디렉터리에 바이너리를 추가해야 합니다.
사전 요구 사항
RHEL 또는 Fedora를 사용하지 않는 경우 libc 가 라이브러리 경로의 디렉터리에 설치되어 있는지 확인합니다.
중요libc를 사용할 수 없는 경우 CLI 명령을 실행할 때 다음과 같은 오류가 표시될 수 있습니다.
$ kn: No such file or directory
절차
관련 Knative(
kn
) CLItar.gz
아카이브를 다운로드합니다.아카이브의 압축을 풉니다.
$ tar -xf <filename>
-
kn
바이너리를PATH
의 디렉터리로 이동합니다. PATH
를 확인하려면 다음을 실행합니다.$ echo $PATH
4.1.4. macOS용 Knative CLI 설치
macOS를 사용하는 경우 Knative(kn
) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 tar.gz
아카이브를 다운로드하여 압축을 풀고 PATH
의 디렉터리에 바이너리를 추가해야 합니다.
절차
-
Knative(
kn
) CLItar.gz
아카이브를 다운로드합니다. - 아카이브의 압축을 해제하고 추출합니다.
-
kn
바이너리를PATH
의 디렉터리로 이동합니다. PATH
를 확인하려면 터미널 창을 열고 다음을 실행합니다.$ echo $PATH
4.1.5. Windows용 Knative CLI 설치
Windows를 사용하는 경우 Knative(kn
) CLI를 바이너리 파일로 설치할 수 있습니다. 이렇게 하려면 ZIP 아카이브를 다운로드하여 압축 해제하고 PATH
의 디렉터리에 바이너리를 추가해야 합니다.
절차
-
Knative(
kn
) CLI ZIP 아카이브를 다운로드합니다. - ZIP 프로그램으로 아카이브의 압축을 풉니다.
-
kn
바이너리를PATH
의 디렉터리로 이동합니다. PATH
를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.C:\> path