쿠버네티스 패키지 저장소 변경하기

쿠버네티스 패키지 저장소 변경하기 (Changing The Kubernetes Package Repository)

이 페이지는 클러스터를 업그레이드할 때 원하는 쿠버네티스 마이너 릴리스용 패키지 저장소를 활성화하는 방법을 설명해요. 이는 pkgs.k8s.io에 호스팅되는 커뮤니티 소유 패키지 저장소 사용자에게만 필요해요. 레거시 패키지 저장소와 달리 커뮤니티 소유 패키지 저장소는 각 쿠버네티스 마이너 버전별 전용 패키지 저장소가 있는 방식으로 구성돼 있어요.

참고: 이 가이드는 쿠버네티스 업그레이드 과정의 일부만 다뤄요. 쿠버네티스 클러스터 업그레이드에 대한 자세한 내용은 업그레이드 가이드를 참고하세요.

참고: 이 단계는 클러스터를 다른 마이너 릴리스로 업그레이드할 때만 필요해요. 같은 마이너 릴리스의 다른 패치 릴리스로 업그레이드한다면(예: v1.37.5에서 v1.37.7로) 이 가이드를 따를 필요가 없어요. 다만 여전히 레거시 패키지 저장소를 사용 중이라면 업그레이드 전에 새 커뮤니티 소유 패키지 저장소로 마이그레이션해야 해요(방법은 다음 섹션 참고).

출처: 문서

본문

시작하기 전에 (Before you begin)

이 문서는 이미 커뮤니티 소유 패키지 저장소(pkgs.k8s.io)를 사용하고 있다고 가정해요. 그렇지 않다면 공식 발표에 설명된 대로 커뮤니티 소유 패키지 저장소로 마이그레이션하는 것을 강력히 권장해요.

참고: 레거시 패키지 저장소(apt.kubernetes.io와 yum.kubernetes.io)는 2023년 9월 13일부터 폐기(deprecated)되고 동결됐어요. pkgs.k8s.io에 호스팅되는 새 패키지 저장소 사용이 강력히 권장되며, 2023년 9월 13일 이후에 릴리스된 쿠버네티스 버전을 설치하려면 필요해요. 폐기된 레거시 저장소와 그 내용물은 향후 추가 통지 없이 언제든지 제거될 수 있어요. 새 패키지 저장소는 v1.24.0부터 시작하는 쿠버네티스 버전용 다운로드를 제공해요.

쿠버네티스 패키지 저장소가 사용되는지 확인하기 (Verifying if the Kubernetes package repositories are used)

커뮤니티 소유 패키지 저장소를 사용 중인지 레거시 패키지 저장소를 사용 중인지 확실하지 않다면 다음 단계로 확인해 보세요.

쿠버네티스 apt 저장소를 정의하는 파일의 내용을 출력해요.

# 여러분의 시스템에서 이 구성 파일의 이름은 다를 수 있음
pager /etc/apt/sources.list.d/kubernetes.list

다음과 비슷한 줄이 보이면:

deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.36/deb/ /

쿠버네티스 패키지 저장소를 사용 중이며 이 가이드가 적용돼요. 그렇지 않다면 공식 발표에 설명된 대로 쿠버네티스 패키지 저장소로 마이그레이션하는 것을 강력히 권장해요.

쿠버네티스 yum 저장소를 정의하는 파일의 내용을 출력해요.

# 여러분의 시스템에서 이 구성 파일의 이름은 다를 수 있음
cat /etc/yum.repos.d/kubernetes.repo

아래 출력의 baseurl과 비슷한 baseurl이 보이면:

[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl

쿠버네티스 zypper 저장소를 정의하는 파일의 내용을 출력해요.

# 여러분의 시스템에서 이 구성 파일의 이름은 다를 수 있음
cat /etc/zypp/repos.d/kubernetes.repo

아래 출력의 baseurl과 비슷한 baseurl이 보이면:

[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl

참고: 쿠버네티스 패키지 저장소에 사용되는 URL은 pkgs.k8s.io로 제한되지 않아요. 다음 중 하나일 수도 있어요.

pkgs.k8s.io

pkgs.kubernetes.io

packages.kubernetes.io

다른 쿠버네티스 패키지 저장소로 전환하기 (Switching to another Kubernetes package repository)

이 단계는 한 쿠버네티스 마이너 릴리스에서 다른 마이너 릴리스로 업그레이드할 때, 원하는 쿠버네티스 마이너 버전의 패키지에 접근하기 위해 수행해야 해요.

선택한 텍스트 편집기로 쿠버네티스 apt 저장소를 정의하는 파일을 열어요.

nano /etc/apt/sources.list.d/kubernetes.list

현재 쿠버네티스 마이너 버전을 포함한 URL이 있는 한 줄이 보일 거예요. 예를 들어 v1.36을 사용 중이라면 다음이 보일 거예요.

deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.36/deb/ /

URL의 버전을 다음 사용 가능한 마이너 릴리스로 변경해요. 예를 들어:

deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.37/deb/ /

파일을 저장하고 텍스트 편집기를 종료해요. 관련 업그레이드 지침을 계속 따라요.

선택한 텍스트 편집기로 쿠버네티스 yum 저장소를 정의하는 파일을 열어요.

nano /etc/yum.repos.d/kubernetes.repo

현재 쿠버네티스 마이너 버전을 포함한 두 개의 URL이 있는 파일이 보일 거예요. 예를 들어 v1.36을 사용 중이라면 다음이 보일 거예요.

[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.36/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni

이 URL들의 버전을 다음 사용 가능한 마이너 릴리스로 변경해요. 예를 들어:

[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v1.37/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.37/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni

파일을 저장하고 텍스트 편집기를 종료해요. 관련 업그레이드 지침을 계속 따라요.

다음 단계 (What's next)

Linux 노드 업그레이드 방법 보기
Windows 노드 업그레이드 방법 보기