自宅で運用しているKubernetesクラスターをv1.30からv1.31にアップグレードしました。 kubeadmを使った標準的なアップグレード手順ですが、忘れがちなので備忘録として残しておきます。 公式ドキュメント: https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/ コントロールプレーンノードのアップグレード コントロールプレーンノードから順番にアップグレードしていきます。 パッケージリポジトリの変更 まず、yumリポジトリの設定ファイルをv1.31用に変更します。 変更前（v1.30）: [kkato@nuc01 ~]$ cat /etc/yum.repos.d/kubernetes.repo [kubernetes] name=Kubernetes baseurl=https://pkgs.k8s.io/core:/stable:/v1.30/rpm/ enabled=1 gpgcheck=1 gpgkey=https://pkgs.k8s.io/core:/stable:/v1.30/rpm/repodata/repomd.xml.key exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni 変更後（v1.31）: $ cat /etc/yum.repos.d/kubernetes.repo [kubernetes] name=Kubernetes baseurl=https://pkgs.k8s.io/core:/stable:/v1.31/rpm/ enabled=1 gpgcheck=1 gpgkey=https://pkgs.k8s.io/core:/stable:/v1.31/rpm/repodata/repomd.xml.key exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni 参考: https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/change-package-repository/ kubeadmのアップグレード まずkubeadmパッケージをアップグレードします。 sudo yum upgrade kubeadm --setopt=disable_excludes=kubernetes アップグレード可能なバージョンを確認します。 sudo kubeadm upgrade plan Components that must be upgraded manually after you have upgraded the control plane with 'kubeadm upgrade apply': COMPONENT NODE CURRENT TARGET kubelet nuc01 v1.30.1 v1.31.14 kubelet nuc02 v1.30.1 v1.31.14 kubelet nuc03 v1.30.1 v1.31.14 kubelet nuc04 v1.30.1 v1.31.14 Upgrade to the latest stable version: COMPONENT NODE CURRENT TARGET kube-apiserver nuc01 v1.30.4 v1.31.14 kube-controller-manager nuc01 v1.30.4 v1.31.14 kube-scheduler nuc01 v1.30.4 v1.31.14 kube-proxy 1.30.4 v1.31.14 CoreDNS v1.11.1 v1.11.3 etcd nuc01 3.5.12-0 3.5.24-0 You can now apply the upgrade by executing the following command: kubeadm upgrade apply v1.31.14 アップグレードを実行します。 ...

最近、Goを勉強していてGORMを触る機会があったので、基本的な部分を調べてみました。 モデル定義 GORMでは構造体をそのままテーブルにマップします。gorm.Modelを埋め込むとIDやCreatedAtなど便利なカラムが自動で付きます。 package main import "gorm.io/gorm" type User struct { gorm.Model Name string Email string `gorm:"uniqueIndex"` Age uint } DB接続とマイグレーション PostgreSQLを例に、DBへ接続し、モデルに沿ってテーブルを自動生成します。dsnは環境に合わせて書き換えてください。 package main import ( "log" "gorm.io/driver/postgres" "gorm.io/gorm" ) func main() { dsn := "host=localhost user=postgres password=postgres dbname=app port=5432 sslmode=disable" db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{}) if err != nil { log.Fatal(err) } // モデルに合わせてテーブルを作成・更新 if err := db.AutoMigrate(&User{}); err != nil { log.Fatal(err) } } CRUD操作 基本的なCRUD操作は以下のように行います。 package main import ( "fmt" "log" "gorm.io/driver/postgres" "gorm.io/gorm" ) type User struct { gorm.Model Name string Email string `gorm:"uniqueIndex"` Age uint } func main() { dsn := "host=localhost user=postgres password=postgres dbname=app port=5432 sslmode=disable" db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{}) if err != nil { log.Fatal(err) } if err := db.AutoMigrate(&User{}); err != nil { log.Fatal(err) } // CREATE: レコードを追加 alice := User{Name: "Alice", Email: "alice@example.com", Age: 28} if err := db.Create(&alice).Error; err != nil { log.Fatal(err) } // READ: 1件取得（主キーまたは条件指定） var user User if err := db.First(&user, "email = ?", "alice@example.com").Error; err != nil { log.Fatal(err) } fmt.Printf("found: %+v\n", user) // UPDATE: 1カラム更新（モデルを指定） if err := db.Model(&user).Update("Age", 29).Error; err != nil { log.Fatal(err) } // DELETE: ソフトデリート（DeletedAtにタイムスタンプが入る） if err := db.Delete(&user).Error; err != nil { log.Fatal(err) } } よく使うクエリの書き方 // 条件付きで複数取得 var users []User db.Where("age >= ?", 25).Order("age desc").Limit(5).Find(&users) // 複数カラムをまとめて更新 db.Model(&user).Updates(map[string]interface{}{ "Name": "Alice Updated", "Age": 30, }) 参考 GORM Official Guides GORM PostgreSQL Driver

自然言語でも日本語という母語があるように、プログラミングでも自分の母語と呼べる言語を持ちたいと考え、最近はGoを本腰入れて勉強しています。その中で HTTP サーバーを実装しようとした際、Gin・Echo・chi など多くの選択肢があり、どのフレームワーク（ライブラリ）を選ぶべきか迷いました。 そんな中、Go 1.22（2024年2月リリース）から標準ライブラリのhttp.ServeMuxが強化されたことを知りました。 この改善により、多くのケースでサードパーティのライブラリが不要になっています。 この記事では、Go 1.22で追加されたServeMuxの新機能について、実例を交えながら解説します。 これまでのServeMux（Go 1.21以前）の課題 Go 1.21以前のServeMuxには、以下のような制約がありました。 HTTPメソッドを指定できない // Go 1.21以前: HTTPメソッドの区別ができない mux := http.NewServeMux() mux.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) { // GET、POST、PUT、DELETEなど、すべてのHTTPメソッドがこのハンドラに来る // 自分でメソッドを判定する必要があった switch r.Method { case http.MethodGet: // GETの処理 case http.MethodPost: // POSTの処理 default: http.Error(w, "Method not allowed", http.StatusMethodNotAllowed) } }) このように、メソッドごとに処理を分けたい場合は、自分でswitch文を書く必要がありました。 パスパラメータを扱えない // Go 1.21以前: パスパラメータが使えない // /users/123 のような動的なパスを扱うには、自分でパースが必要 mux.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) { // URLからIDを手動で抽出する必要があった id := strings.TrimPrefix(r.URL.Path, "/users/") fmt.Fprintf(w, "User ID: %s", id) }) 完全一致が難しい // Go 1.21以前: /users にアクセスしたかったが、/users/ も /users/abc もマッチしてしまう mux.HandleFunc("/users", handler) // これは /users だけでなく /users/ にもマッチする こうした課題から、多くのプロジェクトでサードパーティのルーターライブラリが使われていました。 ...

HelmはKubernetes向けのパッケージマネージャーで、複雑なアプリケーションのデプロイを簡単にしてくれるツールです。 Helmコマンドをよく忘れてしまうので、基本的なコマンドを備忘録としてまとめました。 インストール方法 macOSの場合は以下のコマンドでインストールできます。 brew install helm リポジトリ管理 リポジトリの追加 # リポジトリを追加する helm repo add stable https://charts.helm.sh/stable helm repo add bitnami https://charts.bitnami.com/bitnami リポジトリの一覧表示 # 追加されているリポジトリを確認する helm repo list リポジトリの更新 # リポジトリのインデックスを更新する（新しいチャートバージョンを取得） helm repo update チャートの検索・確認 チャートの検索 # リポジトリからチャートを検索する helm search repo nginx helm search repo mysql チャート情報の表示 # チャートの詳細情報を表示する helm show chart bitnami/nginx helm show values bitnami/nginx リリース管理 インストール # チャートをインストールする helm install my-nginx bitnami/nginx # 名前空間を指定してインストール helm install my-nginx bitnami/nginx -n production --create-namespace # カスタム値でインストール helm install my-nginx bitnami/nginx --set service.type=LoadBalancer リリース一覧の表示 # インストール済みのリリースを表示する helm list # 全ての名前空間のリリースを表示する helm list -A # 特定の名前空間のリリースを表示する helm list -n production リリース情報の確認 # リリースの詳細情報を表示する helm get all my-nginx # リリースの設定値を表示する helm get values my-nginx # リリースの履歴を表示する helm history my-nginx アップグレード # リリースをアップグレードする helm upgrade my-nginx bitnami/nginx # 新しい値でアップグレード helm upgrade my-nginx bitnami/nginx --set image.tag=1.21.0 ロールバック # 前のバージョンにロールバックする helm rollback my-nginx # 特定のリビジョンにロールバックする helm rollback my-nginx 2 アンインストール # リリースを削除する helm uninstall my-nginx # 名前空間を指定して削除 helm uninstall my-nginx -n production 便利なオプション ドライラン 実際にはインストールせずに、何が実行されるかを確認できます。 ...

kubectl get allだとCustom Resourceが表示されないので、全てのリソースが表示できずに困りました。kubectl api-resourcesを使えば、Custom Resourceも含めてサポートされているAPIリソースを全て把握できるので、それを応用して全てのリソースを表示できるようになりました。 備忘録として雑に書いておきます。 全てのリソースを表示する 以下のコマンドで、特定のnamespaceに存在する、全てのリソース(Custom Resourceも含めて)を表示することができます。 kubectl get $(kubectl api-resources --verbs=list --namespaced -o name | grep -v "events" | tr '\n' ',' | sed 's/,$//') -n openebs 各コマンドの説明 kubectl api-resources --verbs=list --namespaced -o name kubectl api-resources: クラスター内の全てのKubernetesリソース種別を表示 --verbs=list: list操作が可能なものに絞る --namespaced: 名前空間に属するリソースに絞る (NamespaceやNodeなどのcluster-scopedリソースは除外) -o name: kubectlで直接使えるリソース名だけを出力 tr '\n' ',' 出力されたリソース名を、改行区切りからカンマ区切りに変換 sed 's/,$//' 末尾に付いてしまった余分なカンマを削除