Skip to content

Commit

Permalink
280 new k8s el repos (#281)
Browse files Browse the repository at this point in the history
* Added new K8s repo changes to kubernetes.md.

* Housekeeping for unused alert templates.

* Adding placeholder for k8s repo change blog post.

* Adding quick blog post on updating SLATE clusters.

* Updated capitalization in 2023-09-11-k8s-community-repos.md.
  • Loading branch information
adamhgriffith-uofu authored Sep 11, 2023
1 parent 9434ae8 commit e5cf73f
Show file tree
Hide file tree
Showing 3 changed files with 48 additions and 9 deletions.
13 changes: 5 additions & 8 deletions _docs/cluster/manual/kubernetes.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,20 +17,18 @@ The SLATE platform uses Kubernetes as its container orchestration system. This s
The Kubernetes repository can be added to the node in the usual way:

```shell
cat <<EOF > /etc/yum.repos.d/kubernetes.repo
export KUBE_VERSION=1.24 && \
cat <<EOF | tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
baseurl=https://pkgs.k8s.io/core:/stable:/v${KUBE_VERSION}/rpm/
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
gpgkey=https://pkgs.k8s.io/core:/stable:/v${KUBE_VERSION}/rpm/repodata/repomd.xml.key
EOF
```
{:data-add-copy-button='true'}

{% include alert/note.html content="To understand why `repo_gpgcheck=0`, see Google's [Known Issues](https://cloud.google.com/compute/docs/troubleshooting/known-issues#keyexpired) page." %}

The Kubernetes install includes a few different pieces: `kubeadm`, `kubectl`, and `kubelet`.

* `kubeadm` is a tool used to bootstrap Kubernetes clusters
Expand All @@ -40,8 +38,7 @@ The Kubernetes install includes a few different pieces: `kubeadm`, `kubectl`, an
Install and enable these components:

```shell
KUBE_VERSION=1.24.* && \
yum install -y kubeadm-${KUBE_VERSION} kubectl-${KUBE_VERSION} kubelet-${KUBE_VERSION} --disableexcludes=kubernetes
yum install -y kubeadm kubectl kubelet
```
{:data-add-copy-button='true'}

Expand Down
1 change: 0 additions & 1 deletion _includes/alert/warning-k8s-version.html

This file was deleted.

43 changes: 43 additions & 0 deletions _posts/2023-09-11-k8s-community-repos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: "Kubernetes Repo Changes"
overview: Kubernetes Community Changes Package Repositories
published: true
permalink: blog/2023-09-11-k8s-community-repos.html
attribution: Adam Griffith
layout: post
type: markdown
---

The Kubernetes community has changed to community-owned package repositories. Learn how to update your SLATE Clusters in this blog.

<!--end_excerpt-->

## What Changed?

* [Kubernetes Legacy Package Repositories Will Be Frozen On September 13, 2023](https://kubernetes.io/blog/2023/08/31/legacy-package-repository-deprecation/)
* [pkgs.k8s.io: Introducing Kubernetes Community-Owned Package Repositories](https://kubernetes.io/blog/2023/08/15/pkgs-k8s-io-introduction/)

## How does this affect us as SLATE Administrators?

The amount of work to change over to the new package repositories is relatively small.

1. SSH to your SLATE Cluster master node.

2. Execute the following to update the package repository file for Kubernetes `1.24.x`.

```shell
export KUBE_VERSION=1.24 && \
cat <<EOF | tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://pkgs.k8s.io/core:/stable:/v${KUBE_VERSION}/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v${KUBE_VERSION}/rpm/repodata/repomd.xml.key
EOF
```
{:data-add-copy-button='true'}
3. Close the connection and repeat the previous command on each of your worker nodes.
4. Continue to update patch versions of the various Kubernetes `1.24.x` packages normally through commands like `yum update ...` or `dnf update ...`.

0 comments on commit e5cf73f

Please sign in to comment.