コンテンツにスキップ

Amazon EKSアドオン@クラウドプロバイダー系

はじめに

本サイトにつきまして、以下をご認識のほど宜しくお願いいたします。


01. Amazon EKSアドオン

Amazon EKSアドオンとは

EKS のコントロールプレーンとデータプレーン上で Kubernetes を稼働させるために必要なアドオン。

マネージドタイプとセルフマネージドタイプがあり、マネージドタイプではアドオンの設定値を AWS が管理し、ユーザーの設定を強制的に上書きする。

一方で、セルフマネージドタイプではユーザーがアドオンの設定値を定義できる。


セットアップ

▼ コンソール画面から

設定項目 説明
バージョン Amazon EKSアドオンのバージョンを設定する。
オプション Amazon EKSアドオンのオプションを設定する。
継承 Amazon EKSのNodeのIAMロールをEKSアドオンにも適用するか否かを設定する。
コンフリクトの解決方法 既存のAmazon EKSアドオンが存在している場合に、上書きするかそのままとするかを設定する。

▼ Terraformの場合

Terraform を使用する。

# AWS CoreDNS
resource "aws_eks_addon" "coredns" {
  cluster_name                = aws_eks_cluster.foo.name
  addon_version               = "<バージョン>"
  addon_name                  = "coredns"
  # Terraformで設定を上書きできるようにする
  resolve_conflicts_on_update = "OVERWRITE"
  # スケジューリングさせるNodeを設定する
  configuration_values = jsonencode(
    {
      nodeSelector = {
        "node.kubernetes.io/nodetype" = "system"
      }
    }
  )
}


# AWS kube-proxy
resource "aws_eks_addon" "kube_proxy" {
  cluster_name                = aws_eks_cluster.foo.name
  addon_version               = "<バージョン>"
  addon_name                  = "kube-proxy"
  # Terraformで設定を上書きできるようにする
  resolve_conflicts_on_update = "OVERWRITE"
}


# Amazon VPC CNI
resource "aws_eks_addon" "vpc_cni" {
  cluster_name                = aws_eks_cluster.foo.name
  addon_version               = "<バージョン>"
  addon_name                  = "vpc-cni"
  # Terraformで設定を上書きできるようにする
  resolve_conflicts_on_update = "OVERWRITE"
  # 環境変数を設定する
  configuration_values = jsonencode(
    {
      env = {
        # Podの上限数を変更する
        MINIMUM_IP_TARGET = "10"
        WARM_IP_TARGET    = "5"
      }
    }
  )
}

▼ Helmの場合

チャートリポジトリからチャートをインストールし、Kubernetes リソースを作成する。

$ helm repo add <チャートリポジトリ名> https://aws.github.io/eks-charts


# AWS CoreDNS
# 執筆時点 (2023/03/02) 時点でチャートなし


# AWS kube-proxy
# 執筆時点 (2023/03/02) 時点でチャートなし


# Amazon VPC CNI
$ helm install <Helmリリース名> <チャートリポジトリ名>/aws-vpc-cni -n kube-system --version <バージョンタグ>


02. AWS CoreDNS

AWS CoreDNSとは

EKS の各 Node 上で、kube-dns という名前の Deployment として稼働する。

同じ Cluster 内のすべての Pod の名前解決をする。

AWS CoreDNS が Amazon EKS Cluster 内にない場合、外部のツール (例:SSO の ID プロバイダーなど) を名前解決できなくなるため、必須である。


設定

▼ バージョン

Kubernetes のバージョンに応じて、異なるアドオンのバージョンを使用する必要がある。


03. AWS Distro for OpenTelemetry

テレメトリーの収集をマネージドにする。

メトリクスの場合、ストレージとアラートをマネージドにした Managed Prometheus と組み合わせると、データの収集 (プル型のみ) から保管までをマネージドにできる。


04. AWS kube-proxy

AWS kube-proxyとは

EKS の各 Node 上で、kube-proxy という名前の DaemonSet として稼働する。

EKS のコントロールプレーン上の kube-apiserver が、Node 外から Pod 内へのリクエストをルーティングできるようにする。

AWS kube-proxy が Amazon EKS Cluster 内にない場合、Pod 内のコンテナのライフサイクルを何も管理できなくなるため、必須である。


設定

▼ バージョン

Kubernetes のバージョンに応じて、異なるアドオンのバージョンを使用する必要がある。


05. AWS Node monitoring agent

Node に関するヘルスチェック (例:Amazon EC2 内の kubelet の正常性) を実施する。

なお、Amazon EC2 に関するヘルスチェック (例:Amazon EC2 の正常性) は、AWS Auto Scaling グループで設定できる。


06. AWS Pod Identity agent

記入中...