상용화 이전: 2026-02-26

B Oracle Kubernetes Engine에 연결

OCI CLI(명령행 인터페이스)를 사용하여 Oracle OKE(Kubernetes Engine) 클러스터에 액세스할 수 있습니다.

다음 지침에서는 kubeconfig 파일을 이미 사용할 수 있다고 가정합니다.

1. OCI CLI를 설치합니다.
   • Linux 또는 macOS에서 다음 명령을 입력합니다.

     bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh

   • Microsoft Windows의 경우 Installing the CLI에서 연결된 .msi 설치 프로그램을 사용합니다.
   OCI CLI에 대한 자세한 내용은 Working with the CLI을 참조하십시오.
2. kubectl을 설치합니다.
   • macOS에서 다음 homebrew 명령을 입력합니다.

     brew install kubectl

   • Linux에서 다음 curl 명령을 입력합니다.

     VERSION=(curl−L−shttps://dl.k8s.io/release/stable.txt)curl−LO"https://dl.k8s.io/release/{VERSION}/bin/linux/amd64/kubectl"; chmod +x kubectl && sudo mv kubectl /usr/local/bin/

   • Microsoft Windows에서는 다음 Chocolatey 명령을 사용합니다.

     choco install kubernetes-cli

   kubectl 설치에 대한 자세한 내용은 Kubernetes 설명서의 Install Tools를 참고하세요.
3. 다음 명령을 입력하여 OCI CLI 인증서를 구성합니다.

   oci setup config

   명령에 다음 정보를 제공합니다.

   • 테넌시 OCID
   • 사용자 OCID
   • 영역(예: ap-mumbai-1)
   • API 키 (지문/개인 키 경로)

   새 API 키를 가져오려면 다음 명령을 입력한 후 ID 및 보안, 사용자, Your User Account, API 키 순으로 선택하여 공개 키를 콘솔에 업로드합니다.

   oci setup keys

4. kubectl에서 액세스할 수 있도록 kubeconfig 파일을 기본 경로에 추가합니다.
   • macOS 및 Linux에서 kubeconfig 파일을 다음 디렉토리에 추가합니다.

     ~/.kube/config

   • Microsoft Windows에서 kubeconfig 파일을 다음 디렉토리에 추가합니다.

     %USERPROFILE%.kube\config

5. Kubernetes 클러스터에 대한 kubeconfig 파일을 생성합니다.
   1. OCI의 클러스터 페이지에서 작업, 클러스터 액세스 순으로 선택합니다. 액세스 클러스터 창이 표시됩니다.
   2. 로컬 액세스를 선택합니다.
   3. 공용 끝점 액세스 명령에 대해 복사를 선택합니다.
   4. 복사한 명령을 실행하여 kubeconfig 파일을 생성합니다.
6. 다음 명령을 실행하여 클러스터에 대한 연결을 검증합니다.

   kubectl cluster-info
   kubectl get nodes -o wide
   kubectl get ns

   프라이빗 끝점 클러스터의 경우 VCN(가상 클라우드 네트워크)에 대한 네트워크 액세스가 필요합니다. 퍼블릭 끝점 클러스터는 API 서버 끝점에 대한 인터넷 접속이 필요합니다.
7. 여러 OCI 프로파일을 사용하는 경우 다음 환경 변수를 설정합니다.
   • Linux 및 macOS: export OCI_CLI_PROFILE=
   • Microsoft Windows: $env:OCI_CLI_PROFILE=""

kubectl이 401 또는 403 오류를 반환하는 경우 ID 및 액세스 관리(IAM) 정책에서 컴파트먼트의 클러스터 패밀리를 사용 및 관리할 수 있는지, 올바른 클러스터 및 영역에 대해 kubeconfig 파일이 생성되었는지 확인합니다.

OKE 클러스터를 확장하려면 다음 단계를 완료합니다.

1. OCI 콘솔에서 OKE 클러스터를 선택한 다음 노드 풀을 선택합니다.
2. 스케일링할 노드 풀을 선택합니다.
3. 작업 메뉴에서 편집을 선택하십시오. 노드 풀 편집 페이지가 표시됩니다.
4. 필요에 따라 노드 수 또는 노드 구성을 변경합니다. 노드 구성을 변경하려면(OCPU 수 및 메모리 양에 영향을 줌) 구성 변경을 선택합니다.
5. 업데이트를 선택하여 변경사항을 확인합니다.
6. 작업 메뉴에서 주기 노드를 선택하여 업데이트된 구성을 적용합니다. 주기 노드 페이지가 표시됩니다.
7. 사이클링 옵션에서 노드 바꾸기를 선택합니다. 최대 급증 및 사용할 수 없는 최대값에 대한 숫자를 입력한 다음 주기 노드를 선택합니다. 노드 풀의 상태가 Active로 업데이트되면 스케일링이 완료됩니다.

또는 스택을 배치하여 설치한 경우 삭제를 눌러 OCI 콘솔에서 현재 스택을 삭제할 수 있습니다. 그런 다음 편집, 스택 편집 순으로 선택하여 스택 정의를 편집하여 필요에 따라 노드 수 또는 노드 구성을 변경할 수 있습니다. 적용 실행 및 변경사항 저장을 선택하여 새 매개변수를 사용하는 스택을 생성합니다.