Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Add-onリスト

Prev Next

VPC環境で利用できます。

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

Add-on 名前 カテゴリ 説明
nks-csi NKS Block Storage CSI storage ブロックストレージを PersistentVolumeとして使用する CSIドライバ
nks-nas-csi NKS NAS (NFS) CSI storage NAS(NFS)ボリュームを PersistentVolumeとして使用する CSIドライバ
external-dns ExternalDNS network Serviceと Ingressの DNS名を外部 DNSに自動的に登録して管理するコントローラ
nks-gateway-adapter NKS Gateway API Adapter network Gateway APIリソース(Gateway、HTTPRoute)を NAVER Cloud ALBに接続するアダプタ
参考

Add-onをインストール・編集する時、Add-onが提供する設定値を入力できます。この文書は、各 Add-onのすべての設定項目の意味と例を説明します。実際に指定できる設定項目と許可範囲は Add-onのバージョンに応じて異なる場合があるため、インストール・編集画面でバージョンを選択すると表示される設定スキーマを基準に指定してください。

NKS Block Storage CSI

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

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

設定値

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

項目 説明 タイプ デフォルト値
scheduling.nodeSelector コンポーネントを配置するノードのラベル条件 オブジェクト(文字列マップ) (なし)
scheduling.extraTolerations
  • テイント(taint)が設定されたノードにもコンポーネントを配置するための tolerationリスト
  • ドライバ動作に必要な必須 tolerationは自動的に含まれて、この項目で削除できない
配列 (なし)
scheduling.extraTolerations[].key 対象テイントキー 文字列 (なし)
scheduling.extraTolerations[].operator キーと値を比較する方式。Exists、Equalのうち1つ 文字列 (なし)
scheduling.extraTolerations[].value operatorが Equalの場合に比較する値 文字列 (なし)
scheduling.extraTolerations[].effect 対象テイントの effect。NoSchedule、PreferNoSchedule、NoExecuteのうち1つ 文字列 (なし)
scheduling.extraTolerations[].tolerationSeconds effectが NoExecuteの場合にノードにとどまる時間(秒) 整数 (なし)

以下は例です。

{
  "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 コンポーネントを配置するノードのラベル条件 オブジェクト(文字列マップ) (なし)
scheduling.extraTolerations
  • テイント(taint)が設定されたノードにもコンポーネントを配置するための tolerationリスト
  • ドライバ動作に必要な必須 tolerationは自動的に含まれて、この項目で削除できない
配列 (なし)
scheduling.extraTolerations[].key 対象テイントキー 文字列 (なし)
scheduling.extraTolerations[].operator キーと値を比較する方式。ExistsEqualのうち1つ。 文字列 (なし)
scheduling.extraTolerations[].value operatorEqualの場合に比較する値 文字列 (なし)
scheduling.extraTolerations[].effect 対象テイントの effect。NoSchedulePreferNoScheduleNoExecuteのうち1つ 文字列 (なし)
scheduling.extraTolerations[].tolerationSeconds effectNoExecuteの場合にノードにとどまる時間(秒) 整数 (なし)

以下は例です。

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

ExternalDNS

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

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

設定値

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

項目 説明 タイプ デフォルト値
sources DNSレコードを作成する対象リソースの種類。serviceingresscrdのうち1つ以上 配列 service, ingress, crd ["ingress"]
domainFilter
  • 管理するドメイン限定
  • 指定したドメインのレコードのみ作成・管理し、空欄にした場合は制限なし
文字列 (空の値) example.com,foo.io
annotationFilter 指定したアノテーションを持つリソースのみ処理対象とする 文字列 (空の値) external-dns.alpha.kubernetes.io/include=true
labelFilter 指定したラベルを持つリソースのみ処理対象とする 文字列 (空の値) team=infra
txtPrefix 所有権記録用 TXTレコード名に付けるプレフィックス 文字列 _edns. _edns.
txtSuffix
  • 所有権記録用 TXTレコード名に付けるサフィックス
  • txtPrefixと一緒に使用できない(以下の注意を参照)
文字列 (空の値) -edns
policy
  • DNSレコード同期ポリシー
  • sync: 作成・変更・削除をすべて反映
  • upsert-only: 削除しない
  • create-only: 作成のみ実行
文字列 upsert-only sync
logLevel ログ出力レベル。debuginfowarnerrorのうち1つ 文字列 info debug
credentials.secretName
  • 外部 DNS認証に使用するアクセスキーが含まれた Secret名
  • 空欄にした場合は、ノードの Node IAM Roleで認証
  • Secretはユーザーの事前作成必要(以下を参照)
文字列 (空の値) external-dns-credentials
scheduling.nodeSelector コンポーネントを配置するノードのラベル条件 オブジェクト(文字列マップ) (なし) {"role":"external-dns"}
scheduling.extraTolerations テイント(taint)が設定されたノードにもコンポーネントを配置するための tolerationリスト 配列 (なし)
scheduling.extraTolerations[].key 対象テイントキー 文字列 (なし) dedicated
scheduling.extraTolerations[].operator キーと値を比較する方式。ExistsEqualのうち1つ 文字列 (なし) Equal
scheduling.extraTolerations[].value operatorEqualの場合に比較する値 文字列 (なし) dns
scheduling.extraTolerations[].effect 対象テイントの effect。NoSchedulePreferNoScheduleNoExecuteのうち1つ 文字列 (なし) NoSchedule
scheduling.extraTolerations[].tolerationSeconds effectNoExecuteの場合にノードにとどまる時間(秒) 整数 (なし) 300

以下は例です。

{
  "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 コンポーネントを配置するノードのラベル条件 オブジェクト(文字列マップ) (なし)
scheduling.extraTolerations テイント(taint)が設定されたノードにもコンポーネントを配置するための tolerationリスト 配列 (なし)
scheduling.extraTolerations[].key 対象テイントキー。 文字列 (なし)
scheduling.extraTolerations[].operator キーと値を比較する方式。ExistsEqualのうち1つ 文字列 (なし)
scheduling.extraTolerations[].value operatorEqualの場合に比較する値 文字列 (なし)
scheduling.extraTolerations[].effect 対象テイントの effect。NoSchedulePreferNoScheduleNoExecuteのうち1つ 文字列 (なし)
scheduling.extraTolerations[].tolerationSeconds effectNoExecuteの場合にノードにとどまる時間(秒) 整数 (なし)

以下は例です。

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

バージョン互換性

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