Go to Qiita Advent Calendar 2024 Top
LoginSignup
2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

@s_horikoshi(堀越 誠一朗)inWealthy Design 株式会社

Amazon EKSでAWS Load Balancer Controllerを利用する

Last updated at Posted at 2022-10-25

はじめに

Amazon EKSでAWS Load Balancer Controllerを利用する方法をまとめます。
AWS Load Balancer Controllerは、KubernetesクラスターのElastic Load Balancerの管理ができるコントローラーです。
AWS Load Balancer Controllerを利用するとALBが構築されます。

Mac環境を想定しています。

実行環境の準備

  1. AWS CLIの設定
    AWS CloudFormationを動かすためのAWS CLIの設定を参考にしてください。

  2. EKSクラスタの構築
    Macでeksctlを利用してAmazon EKSのクラスターを構築するを参考にしてください。

  3. EKSのコンテキストの設定
    MacにてAmazon EKSの設定をするを参考にしてください。

  4. Helmの設定
    Amazon EKSでHelmを利用するを参考にしてください。

  5. ArgoCDの設定
    Amazon EKSでArgoCDを利用するを参考にしてください。

IAM OIDC IDプロバイダの作成

クラスター用の IAM OIDC プロバイダーの作成を参考にしてください。

  1. クラスター名を設定する

    CLUSTER_NAME=${クラスター名}

  2. IDプロバイダを作成する

    eksctl utils associate-iam-oidc-provider \
  --cluster ${CLUSTER_NAME} \
  --approve

  3. IDプロバイダのARNを取得する

  4. OIDC_ARN=$(aws iam list-open-id-connect-providers \
  --query "OpenIDConnectProviderList[*].Arn" \
  --output text \
| grep $( \
  aws eks describe-cluster \
    --name ${CLUSTER_NAME} \
    --query "cluster.identity.oidc.issuer" \
    --output text \
    | cut -d '/' -f 5 \
  )
)

  5. IDプロバイダ名を取得する

    OIDC_NAME=$(aws iam get-open-id-connect-provider \
  --query "Url" \
  --output text \
  --open-id-connect-provider-arn \
  $( \
    aws iam list-open-id-connect-providers \
      --query "OpenIDConnectProviderList[*].Arn" \
      --output text \
    | grep $( \
      aws eks describe-cluster \
        --name ${CLUSTER_NAME} \
        --query "cluster.identity.oidc.issuer" \
        --output text \
        | cut -d '/' -f 5 \
      ) \
  )
)

IAMロールの作成

  1. IAMロールを作成する
    ※今回はロール名をakane-dev-aws-load-balancer-controller-roleにしています。

    ROLE_POLICY=$(echo -n '{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Federated": "'; echo -n "${OIDC_ARN}"; echo -n '"
            },
            "Action": "sts:AssumeRoleWithWebIdentity",
            "Condition": {
                "StringEquals": {
                    "'; echo -n "${OIDC_NAME}"; echo -n ':sub": "system:serviceaccount:kube-system:aws-load-balancer-controller"
                }
            }
        }
    ]
}')
aws iam create-role \
  --role-name akane-dev-aws-load-balancer-controller-role \
  --assume-role-policy-document "${ROLE_POLICY}"

  2. ポリシーを作成する
    ※ポリシーを参考にしてください。
    ※今回はポリシー名をakane-dev-aws-load-balancer-controller-policyにしています。

    aws iam create-policy \
    --policy-name akane-dev-aws-load-balancer-controller-policy \
    --policy-document "$(curl -s https://raw.githubusercontent.com/kubernetes-sigs/aws-load-balancer-controller/v2.4.4/docs/install/iam_policy.json)"

  3. ポリシーをロールにアタッチする

    export ACCOUNT_ID=$(aws sts get-caller-identity --output text --query Account)
aws iam attach-role-policy \
  --role-name akane-dev-aws-load-balancer-controller-role \
  --policy-arn arn:aws:iam::${ACCOUNT_ID}:policy/akane-dev-aws-load-balancer-controller-policy

環境設定

※事前にKubernetesクラスターのコンテキストの設定をします。
※ArgoCDのインストールが必要です。

  1. VPC IDを取得する

    aws ec2 describe-tags \
  --filter "Name=tag-value,Values=eksctl-*-cluster/VPC" \
  --query "Tags[].ResourceId" \
  --output text

  2. IAMロールのARNを取得する
    ※今回はロール名をakane-dev-aws-load-balancer-controller-roleにしています。

    aws iam get-role \
  --role-name akane-dev-aws-load-balancer-controller-role \
  --query "Role.Arn" \
  --output text

  3. aws-load-balancer-controller.yamlを作成する
    ※targetRevisionは1.4.4としていますが、最新バージョンはeks-charts/stable/aws-load-balancer-controller/で確認してください。
    ※VPCのID、クラスター名、IAMロールのARNを設定します。

    aws-load-balancer-controller.yaml
    apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: aws-load-balancer-controller
  namespace: argocd
  finalizers:
    - resources-finalizer.argocd.argoproj.io
spec:
  project: default
  source:
    repoURL: 'https://aws.github.io/eks-charts'
    targetRevision: 1.4.4
    chart: aws-load-balancer-controller
    helm:
      parameters:
        - name: region
          value: ap-northeast-1
        - name: vpcId
          value: ${VPCのID}
        - name: clusterName
          value: ${クラスター名}
      values: |
        serviceAccount:
          create: true
          name: aws-load-balancer-controller
          annotations:
            eks.amazonaws.com/role-arn: ${IAMロールのARN}
  destination:
    server: 'https://kubernetes.default.svc'
    namespace: kube-system
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

  4. クラスターに適用する

    kubectl apply -f aws-load-balancer-controller.yaml

[サンプル] guestbookのマニフェスト

※今回はakaneというNamespaceでguestbookを作成します。
※guestbookを参考にしてください。

  1. akane-namespace.yaml を作成する

    akane-namespace.yaml
    apiVersion: v1
kind: Namespace
metadata:
  name: akane
  labels:
    name: akane

  2. akane-ingress.yaml を作成する

    akane-ingress.yaml
    apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    kubernetes.io/ingress.class: alb
    alb.ingress.kubernetes.io/scheme: internet-facing
    alb.ingress.kubernetes.io/target-type: ip
  name: guestbook-ui
  namespace: akane
spec:
  rules:
  - http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: guestbook-ui
            port:
              number: 3000

  3. akane-service.yaml を作成する
    ※guestbook-ui-svc.yaml を参考にする

    akane-service.yaml
    apiVersion: v1
kind: Service
metadata:
  annotations:
  labels:
    app: guestbook-ui
  name: guestbook-ui
  namespace: akane
spec:
  ports:
  - port: 3000
    protocol: TCP
    targetPort: 80
  selector:
    app: guestbook-ui
  type: NodePort

  4. akane-deployment.yaml を作成する
    ※guestbook-ui-deployment.yaml を参考にする

    akane-deployment.yaml
    apiVersion: apps/v1
kind: Deployment
metadata:
  name: guestbook-ui
  namespace: akane
spec:
  replicas: 1
  revisionHistoryLimit: 3
  selector:
    matchLabels:
      app: guestbook-ui
  template:
    metadata:
      labels:
        app: guestbook-ui
    spec:
      containers:
      - image: gcr.io/heptio-images/ks-guestbook-demo:0.2
        name: guestbook-ui
        ports:
        - containerPort: 80

  5. クラスターに適用する

    kubectl apply -f akane-namespace.yaml
kubectl apply -f akane-ingress.yaml
kubectl apply -f akane-service.yaml
kubectl apply -f akane-deployment.yaml

  6. guestbook にアクセスする
    ※ELBが構築されるまで、数分アクセスできないことがあります。

    open "http://$(kubectl get ingress -n akane guestbook-ui | awk '{ print $4 }' | tail -1)"

クリーンアップ

  1. クラスターから削除する

    kubectl delete -f akane-deployment.yaml
kubectl delete -f akane-service.yaml
kubectl delete -f akane-ingress.yaml
kubectl delete -f akane-namespace.yaml
kubectl delete -f aws-load-balancer-controller.yaml

  2. ポリシーをロールからデタッチする

    export ACCOUNT_ID=$(aws sts get-caller-identity --output text --query Account)
aws iam detach-role-policy \
  --role-name akane-dev-aws-load-balancer-controller-role \
  --policy-arn arn:aws:iam::${ACCOUNT_ID}:policy/akane-dev-aws-load-balancer-controller-policy

  3. ポリシーを削除する

    export ACCOUNT_ID=$(aws sts get-caller-identity --output text --query Account)
aws iam delete-policy \
  --policy-arn arn:aws:iam::${ACCOUNT_ID}:policy/akane-dev-aws-load-balancer-controller-policy

  4. IAMロールを削除する

    aws iam delete-role \
  --role-name akane-dev-aws-load-balancer-controller-role

  5. IAM OIDC IDを削除する
    eksctl delete clusterを実行するとクラスターと一緒に削除されます。

参考

AWS Load Balancer Controller アドオンのインストール

2
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?