Terraform 用の Amazon EKS ブループリント

Terraform の Amazon EKS ブループリントへようこそ!

このリポジトリには、お客様がAmazon EKSをより簡単かつ迅速に採用できるようにすることを目的とした Terraform モジュールのコレクションが含まれています。AWS のお客様、パートナー、社内の AWS チームが使用して、ワークロードのデプロイと運用に必要な運用ソフトウェアで完全にブートストラップされた完全な EKS クラスターを構成および管理できます。

このプロジェクトは、コミュニティの terraform-aws-eksモジュールを活用して、EKS クラスターをデプロイします。

入門

EKS ブループリントの使用を開始する最も簡単な方法は、入門ガイドに従うことです。

ドキュメンテーション

完全なプロジェクト ドキュメントについては、ドキュメント サイトを参照してください。

例

EKS ブループリントを活用する方法の例を表示するには、 examplesディレクトリを参照してください。

使用法

以下は、EKS ブループリントを活用して、EKS クラスター、マネージド ノード グループ、およびさまざまな Kubernetes アドオンをデプロイする方法を示しています。

module "eks_blueprints" {
  source = "github.com/aws-ia/terraform-aws-eks-blueprints?ref=v4.0.2"

  # EKS CLUSTER
  cluster_version           = "1.21"
  vpc_id                    = "<vpcid>"                                      # Enter VPC ID
  private_subnet_ids        = ["<subnet-a>", "<subnet-b>", "<subnet-c>"]     # Enter Private Subnet IDs

  # EKS MANAGED NODE GROUPS
  managed_node_groups = {
    mg_m5 = {
      node_group_name = "managed-ondemand"
      instance_types  = ["m5.large"]
      subnet_ids      = ["<subnet-a>", "<subnet-b>", "<subnet-c>"]
    }
  }
}

module "eks_blueprints_kubernetes_addons" {
  source = "github.com/aws-ia/terraform-aws-eks-blueprints//modules/kubernetes-addons?ref=v4.0.2"

  eks_cluster_id = module.eks_blueprints.eks_cluster_id

  # EKS Addons
  enable_amazon_eks_vpc_cni            = true
  enable_amazon_eks_coredns            = true
  enable_amazon_eks_kube_proxy         = true
  enable_amazon_eks_aws_ebs_csi_driver = true

  #K8s Add-ons
  enable_argocd                       = true
  enable_aws_for_fluentbit            = true
  enable_aws_load_balancer_controller = true
  enable_cluster_autoscaler           = true
  enable_metrics_server               = true
  enable_prometheus                   = true
}

上記のコードは、以下をプロビジョニングします。

• ✅管理対象ノード グループを持つ新しい EKS クラスター。
• ✅Amazon EKS アドオン

  vpc-cni

  、

  CoreDNS

  、

  kube-proxy

  、および

  aws-ebs-csi-driver

  .
• ✅

  Cluster Autoscaler

  Metrics Server

  ワークロードをスケーリングするために。
• ✅

  Fluent Bit

  ルーティング ログ用。
• ✅

  AWS Load Balancer Controller

  トラフィックを分散するため。
• ✅

  Argocd

  Kubernetes 用の宣言型 GitOps CD 用。
• ✅

  Prometheus

  可観測性のために。

アドオン

EKS Blueprints を使用すると、幅広い一般的な Kubernetes アドオンを EKS クラスターに簡単にプロビジョニングできます。デフォルトでは、Terraform Helm プロバイダーは、公開されているHelm チャートを使用してアドオンをデプロイするために使用されます。EKS Blueprints は、自己ホスト型の Helm チャートを活用するためのサポートも提供します。

アドオンの展開に関する完全なドキュメントについては、アドオンのドキュメントを参照してください。

サブモジュール

ルートモジュールは、Amazon EKS と連携して使用できる多数の外部 AWS サービスのデプロイと統合をサポートする複数のサブモジュールを呼び出します。これには、Amazon Managed Prometheus と EKS 上の EMR が含まれます。外部サービスの展開に関する完全なドキュメントについては、サブモジュールのドキュメントを参照してください。

動機

Kubernetes は、コンテナ化されたアプリケーションを大規模にデプロイおよび管理できる、強力で拡張可能なコンテナ オーケストレーション テクノロジーです。Kubernetes の拡張可能な性質により、Kubernetes クラスターで、一般にアドオンと呼ばれるさまざまな一般的なオープンソース ツールを使用することもできます。ただし、利用可能なツールと設計の選択肢が非常に多いため、アプリケーション固有のニーズを満たすように調整された EKS クラスターを構築するには、かなりの時間がかかる場合があります。これには、幅広いオープンソース ツールと AWS サービスの統合が含まれ、AWS と Kubernetes に関する深い専門知識が必要です。

AWS のお客様は、Kubernetes ツールのランドスケープを統合し、特定のアプリケーション要件を満たす完全で独自の EKS クラスターを簡単にプロビジョニングする方法を示す例を求めてきました。お客様は、EKS ブループリントを使用して、専用の EKS クラスターを構成およびデプロイし、数か月ではなく数日でワークロードのオンボーディングを開始できます。

サポートとフィードバック

Terraform の EKS ブループリントは、AWS ソリューション アーキテクトによって管理されています。これは AWS サービスの一部ではなく、サポートは EKS Blueprints コミュニティによって最善を尽くして提供されます。

フィードバックを投稿したり、機能のアイデアを送信したり、バグを報告したりするには、この GitHub リポジトリの問題セクションを使用してください。

アーキテクチャの詳細、段階的な手順、およびカスタマイズ オプションについては、ドキュメント サイトを参照してください。

EKS ブループリントへの貢献に関心がある場合は、貢献ガイドを参照してください。

要件

プロバイダ

モジュール

資力

入力

any

{}

map(string)

{}

string

null

number

90

list(string)

[]

list(string)

[
  "api",
  "audit",
  "authenticator",
  "controllerManager",
  "scheduler"
]

list(object({
    provider_key_arn = string
    resources        = list(string)
  }))

[]

bool

false

bool

true

list(string)

[
  "0.0.0.0/0"
]

any

{}

ipv4

ipv6

string

"ipv4"

list(string)

[]

string

null

number

30

string

""

source_node_security_group = true

node_security_group

any

{}

string

""

map(string)

{}

string

null

string

null

map(string)

{}

<major>.<minor>

1.22

string

"1.22"

list(string)

[]

bool

false

bool

true

bool

true

bool

true

node_security_group_id

bool

true

list(string)

[]

number

"600"

any

{}

bool

false

bool

true

bool

false

any

{}

list(string)

[]

create_iam_role

false

string

null

string

null

string

null

string

null

any

{}

list(string)

[]

list(object({
    rolearn  = string
    username = string
    groups   = list(string)
  }))

[]

list(object({
    userarn  = string
    username = string
    groups   = list(string)
  }))

[]

source_cluster_security_group = true

cluster_security_group

any

{}

map(string)

{}

list(string)

[]

any

{}

list(string)

[]

list(string)

[]

any

{}

map('BusinessUnit

XYZ

map(string)

{}

string

list(string)

[]

出力

enable_irsa = true

https://

安全

詳細については、貢献を参照してください。

ライセンス

Apache-2.0 ライセンス。ライセンスを参照してください。