Add-onリスト

VPC環境で利用できます。

Ncloud Kubernetes Service(NKS)が提供する Add-onリストです。

NKS Block Storage CSI

ブロックストレージを Kubernetes PersistentVolumeとして使用する CSIドライバです。この Add-onをインストールすると、ブロックストレージベースボリュームを動的にプロビジョニングして Podにマウントできます。

インストール後の使用方法は、ブロックストレージ CSI のユースケースをご参照ください。

設定値

提供する設定項目は次の通りです。

以下は例です。

{
  "scheduling": {
    "nodeSelector": {
      "role": "storage"
    },
    "extraTolerations": [
      {
        "key": "dedicated",
        "operator": "Equal",
        "value": "storage",
        "effect": "NoSchedule"
      }
    ]
  }
}

NKS NAS (NFS) CSI

NAS(NFS)ボリュームを Kubernetes PersistentVolumeとして使用する CSIドライバです。複数の Podが同時にアクセスする共有ボリュームが必要な場合に使用します。

インストール後の使用方法は、NASボリューム CSI のユースケースをご参照ください。

設定値

提供する設定項目は次の通りです。

以下は例です。

{
  "scheduling": {
    "nodeSelector": {
      "role": "storage"
    },
    "extraTolerations": [
      {
        "key": "dedicated",
        "operator": "Equal",
        "value": "storage",
        "effect": "NoSchedule"
      }
    ]
  }
}

ExternalDNS

Kubernetesの Serviceと Ingressに設定された DNS名を外部 DNSサービスに自動的に登録して管理するコントローラです。この Add-onをインストールすると、ワークロードが公開するドメインを手動で管理する必要がなくなります。

インストール後の使用方法は、ExternalDNS活用のユースケースをご参照ください。

設定値

ExternalDNSが提供する設定項目は次の通りです。

以下は例です。

{
  "sources": ["service", "ingress", "crd"],
  "domainFilter": "example.com,foo.io",
  "annotationFilter": "external-dns.alpha.kubernetes.io/include=true",
  "labelFilter": "team=infra",
  "txtPrefix": "",
  "txtSuffix": "-edns",
  "policy": "sync",
  "logLevel": "info",
  "credentials": {
    "secretName": "external-dns-credentials"
  },
  "scheduling": {
    "nodeSelector": {
      "role": "external-dns"
    },
    "extraTolerations": [
      {
        "key": "dedicated",
        "operator": "Equal",
        "value": "dns",
        "effect": "NoSchedule"
      }
    ]
  }
}

NKS Gateway API Adapter

Gateway APIリソース(Gateway、HTTPRoute)を NAVER Cloud Application Load Balancer(ALB)に接続するアダプタです。この Add-onをインストールすると Gateway API標準リソースで外部トラフィックルーティングを構成できます。

インストール後の使用方法は、Gateway API を使用するをご参照ください。

設定値

提供する設定項目は次の通りです。

以下は例です。

{
  "scheduling": {
    "nodeSelector": {
      "role": "gateway"
    },
    "extraTolerations": [
      {
        "key": "dedicated",
        "operator": "Equal",
        "value": "gateway",
        "effect": "NoSchedule"
      }
    ]
  }
}

Istio

Istioはクラスタ間のサービス間通信にトラフィック管理、mTLSベースのセキュリティ、可観測性を提供するサービスメッシュです。この Add-onは、Istioのコントロールプレーン(istiod)をインストールします。サイドカー注入とメッシュ機能の使用方法は、Istio公式ドキュメントをご参照ください。

この Add-onは、Canaryアップグレードをサポートします。インストールしたバージョン系列ごとに Revision(例: バージョン 1.30.3の Revisionは 1-30)を持ち、各ネームスペースでは istio.io/revラベルでサイドカーを注入される Revisionを指定します。アップグレードの手順は、Add-onのインストールと管理の Canaryアップグレードをご参照ください。

設定値

Istioが提供する設定項目は次の通りです。meshConfig項目は Istioのメッシュ設定(MeshConfig)がそのまま渡されるため、各項目の動作については Istio MeshConfigリファレンスをご参照ください。

以下は例です。

{
  "meshConfig": {
    "accessLogFile": "/dev/stdout",
    "accessLogEncoding": "JSON",
    "outboundTrafficPolicy": { "mode": "REGISTRY_ONLY" },
    "meshMTLS": { "minProtocolVersion": "TLSV1_2" },
    "extensionProviders": [
      {
        "name": "otel",
        "opentelemetry": {
          "service": "otel-collector.observability.svc.cluster.local",
          "port": 4317
        }
      }
    ]
  },
  "nodeSelector": { "role": "mesh" },
  "tolerations": [
    { "key": "dedicated", "operator": "Equal", "value": "mesh", "effect": "NoSchedule" }
  ]
}

Canaryアップグレードとワークロードの切り替え

Canaryアップグレードが始まると、新しい Revisionのコントロールプレーンが既存の Revisionと同時にインストールされます。ワークロードはネームスペースの istio.io/revラベルに指定された Revisionを使用し続けるため、ラベルを新しい Revisionに変更してワークロードを再起動すると、再起動後の Podから新しい Revisionのサイドカーで動作します。影響範囲が小さいネームスペースから順次切り替え、正常動作することを確認します。

# ネームスペースを新しい revision(例: 1-30)に切り替え
kubectl label namespace <namespace> istio.io/rev=1-30 --overwrite

# ワークロード再起動(再起動された Podから新しい revisionを適用)
kubectl rollout restart deployment -n <namespace>

問題が見つかった場合はラベルを既存の Revisionに戻し、再起動すると既存の Revisionに戻ります。

Revisionベースアップグレードの詳細な動作は、Istio公式ドキュメントの Canaryアップグレードをご参照ください。

バージョン互換性

インストールできる Add-onのバージョンはクラスタの Kubernetesバージョンに応じて異なります。インストールと変更のときに、クラスタと互換性のあるバージョンのみ選択できます。Add-on別サポートバージョンは、Add-onバージョンのバージョン互換性表をご参照ください。