Kf CLI 설치

이 문서에서는 Kf CLI 설치 방법을 설명합니다. 일반적으로 Kf를 실행하는 GKE 클러스터에 대해 액세스 권한이 이미 있을 때 Kf CLI를 설치합니다. 즉, 먼저 GKE 클러스터를 만들지 않고도 Kf 명령어 사용을 시작할 수 있습니다.

Kf CLI를 설치하고 Kf 클러스터에 연결한 다음에는 모든 Kf 명령어를 실행할 수 있습니다. 사용 가능한 전체 Kf 명령어 목록은 Kf 명령어 참조를 확인하세요.

시작하기 전에

Kf CLI를 사용하려면 먼저 전체 Kf 설치를 실행하는 GKE 클러스터에 액세스할 수 있어야 합니다. 즉, 다음 명령어를 실행하여 클러스터에 연결한 상태여야 합니다.

gcloud container clusters get-credentials CLUSTER_NAME \
    --project=CLUSTER_PROJECT_ID \
    --zone=CLUSTER_LOCATION

CLI 설치

  1. Kf CLI를 설치합니다.

    Linux

    이 명령어는 시스템의 모든 사용자에 대해 Kf CLI를 설치합니다. Cloud Shell 탭의 안내에 따라 직접 설치합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    이 명령어는 시스템의 모든 사용자에 대해 kf를 설치합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    이 명령어는 bash를 사용하는 경우 Cloud Shell 인스턴스에 kf를 설치합니다. 다른 셸의 경우 지침을 수정해야 할 수 있습니다.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    이 명령어는 kf를 현재 디렉터리에 다운로드합니다. 현재 디렉터리 이외의 다른 곳에서 호출하려는 경우 경로에 추가합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

CLI 업그레이드

기존에 설치된 Kf CLI가 있다면 다음 절차에 따라 현재 버전으로 업그레이드할 수 있습니다.

  1. CLI를 설치합니다.

    Linux

    이 명령어는 시스템의 모든 사용자에 대해 Kf CLI를 설치합니다. Cloud Shell 탭의 안내에 따라 직접 설치합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    이 명령어는 시스템의 모든 사용자에 대해 kf를 설치합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    이 명령어는 bash를 사용하는 경우 Cloud Shell 인스턴스에 kf를 설치합니다. 다른 셸의 경우 지침을 수정해야 할 수 있습니다.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    kf를 현재 디렉터리에 다운로드합니다. 현재 디렉터리 이외의 다른 곳에서 호출하려는 경우 경로에 추가합니다.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

  2. Kf CLI 및 Kf 서버 버전이 일치하는지 확인합니다.

    • CLI 버전은 Kf Client 아래에 나열됩니다.
    • Kf 서버 버전은 kf["app.kubernetes.io/version"] 아래에 나열됩니다.
    $ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...