AWS re:Postを使用することにより、以下に同意したことになります AWS re:Post 利用規約
AWS re:Postre:Post

Amazon EKS で ExternalDNS を設定する方法

所要時間4分
0

自分の Amazon Elastic Kubernetes サービス (Amazon EKS) で ExternalDNS を設定したいと考えています。

簡単な説明

ExternalDNS をインストールするには、AWS Identity and Access Management (IAM) のアクセス権限を使用して Amazon EKS に Amazon Route 53 との通信に必要なアクセス権限を付与します。

**注:**次の解決策を始める前に、ドメイン名と Route 53 ホストゾーンがあることを確認してください。

解決策

IAM アクセス許可を設定して ExternalDNS をデプロイする

次の手順を実行します。

  1. 次のポリシーを作成して、AWS アカウント内に Route 53 レコードを作成、更新、削除するアクセス許可を ExternalDNS ポッドに付与するように、IAM アクセス許可を設定します。

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "route53:ChangeResourceRecordSets"
      ],
      "Resource": [
        "arn:aws:route53:::hostedzone/"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "route53:ListHostedZones",
        "route53:ListResourceRecordSets",
        "route53:ListTagsForResource"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

    **注:**前述のポリシーを変更して、特定のホストゾーン ID の更新を許可できます。

  2. このポリシーを使用して、サービスアカウントに IAM ロールを作成します。

    eksctl create iamserviceaccount --name SERVICE_ACCOUNT_NAME --namespace NAMESPACE
--cluster CLUSTER_NAME --attach-policy-arn IAM_POLICY_ARN --approve

    注: SERVICE_ACCOUNT_NAME をサービスアカウントの名前、NAMESPACE を名前空間、CLUSTER_NAME をクラスターの名前、そして IAM\ _POLICY\ _ARN を IAM ポリシーの ARN に置き換えてください。
    サービスアカウントの名前を確認するには、次のコマンドを実行します。

    kubectl get sa

    次の出力例では、external-dns はサービスアカウントにその作成時に付けられた名前です。

    NAME           SECRETS   AGE
default        1         23h
external-dns   1         23h

  3. 次のコマンドを実行して、Amazon EKS クラスターで RBAC が有効になっているかどうかを確認します。

    kubectl api-versions | grep rbac.authorization.k8s.io

    **注:**前述のコマンドでは、GitHub プロジェクトで利用可能な ExternalDNS の最新バージョンを確認してください。

  4. 次のコマンドを実行して外部 DNS をデプロイします。

    kubectl apply DEPLOYMENT_MANIFEST_FILE_NAME.yaml

    注: DEPLOYMENT_MANIFEST_FILE_NAME をデプロイマニフェストのファイル名に置き換えてください。

    RBAC がオンになっている場合は、次のマニフェストを使用して ExternalDNS をデプロイします。

    apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: external-dns
  labels:
    app.kubernetes.io/name: external-dns
rules:
  - apiGroups: [""]
    resources: ["services","endpoints","pods","nodes"]
    verbs: ["get","watch","list"]
  - apiGroups: ["extensions","networking.k8s.io"]
    resources: ["ingresses"]
    verbs: ["get","watch","list"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: external-dns-viewer
  labels:
    app.kubernetes.io/name: external-dns
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: external-dns
subjects:
  - kind: ServiceAccount
    name: external-dns
    namespace: default # change to desired namespace: externaldns, kube-addons
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-dns
  labels:
    app.kubernetes.io/name: external-dns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app.kubernetes.io/name: external-dns
  template:
    metadata:
      labels:
        app.kubernetes.io/name: external-dns
    spec:
      serviceAccountName: external-dns
      containers:
        - name: external-dns
          image: registry.k8s.io/external-dns/external-dns:v0.14.0
          args:
            - --source=service
            - --source=ingress
            - --domain-filter=example.com # will make ExternalDNS see only the hosted zones matching provided domain, omit to process all available hosted zones
            - --provider=aws
            - --policy=upsert-only # would prevent ExternalDNS from deleting any records, omit to enable full synchronization
            - --aws-zone-type=public # only look at public hosted zones (valid values are public, private or no value for both)
            - --registry=txt
            - --txt-owner-id=external-dns
          env:
            - name: AWS_DEFAULT_REGION
              value: eu-west-1 # change to region where EKS is installed

    RBAC がオンになっていない場合は、次のマニフェストを使用して ExternalDNS をデプロイします。

    apiVersion: apps/v1
kind: Deployment
metadata:
  name: external-dns
  labels:
    app.kubernetes.io/name: external-dns
spec:
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app.kubernetes.io/name: external-dns
  template:
    metadata:
      labels:
        app.kubernetes.io/name: external-dns
    spec:
      containers:
        - name: external-dns
          image: registry.k8s.io/external-dns/external-dns:v0.14.0
          args:
            - --source=service
            - --source=ingress
            - --domain-filter=example.com # will make ExternalDNS see only the hosted zones matching provided domain, omit to process all available hosted zones
            - --provider=aws
            - --policy=upsert-only # would prevent ExternalDNS from deleting any records, omit to enable full synchronization
            - --aws-zone-type=public # only look at public hosted zones (valid values are public, private or no value for both)
            - --registry=txt
            - --txt-owner-id=my-hostedzone-identifier
          env:
            - name: AWS_DEFAULT_REGION
              value: eu-west-1 # change to region where EKS is installed

  5. 次のコマンドを実行して、デプロイが成功したことを確認します。

    kubectl get deployments

    出力例:

    NAME           READY   UP-TO-DATE   AVAILABLE   AGE
external-dns   1/1     1            1           85m

    または、ログをチェックして、レコードが更新されていることを確認します。

    kubectl logs external-dns-9f85d8d5b-sx5f

    出力例:

    ....
time="2023-12-14T17:16:16Z" level=info msg="Instantiating new Kubernetes client"
time="2023-12-14T17:16:16Z" level=info msg="Using inCluster-config based on serviceaccount-token"
time="2023-12-14T17:16:16Z" level=info msg="Created Kubernetes client https://10.100.0.1:443"
time="2023-12-14T17:16:18Z" level=info msg="Applying provider record filter for domains: [xxxxx.people.aws.dev. .xxxxx.people.aws.dev. xxxxx.people.aws.dev. .xxxxx.people.aws.dev.]"
time="2023-12-14T17:16:18Z" level=info msg="All records are already up to date"
....

ExternalDNS の検証

ExternalDNS が正しく設定されていることを確認するには、次の手順を実行します。

  1. **LoadBalancer ** として公開されるサービスを作成します。サービスは、Route 53 でホストされているドメイン名を介して外部にルーティングする必要があります。

    kubectl apply SERVICE_MANIFEST_FILE_NAME.yaml

Note: Replace SERVICE_MANIFEST_FILE_NAME with your service manifest's file name.

Manifest:

apiVersion: v1
kind: Service
metadata:
  name: nginx
  annotations:
    external-dns.alpha.kubernetes.io/hostname: nginx.xxxxx.people.aws.dev
spec:
  ports:
    - port: 80
      targetPort: 80
      protocol: TCP
  type: LoadBalancer
  selector:
    app: nginx

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - image: nginx
          name: nginx
          ports:
            - containerPort: 80
              name: http

    **注:**ExternalDNS はサービスに external-dns.alpha.kubernetes.io/hostname アノテーションを使用します。関連する値も使用します。サービスに複数の名前を割り当てるには、external-dns.alpha.kubernetes.io/hostname アノテーションをコンマ区切りを使用して設定します。

  2. NGINX サービスが LoadBalancer タイプで作成されていることを確認します。

    kubectl get svc

    出力例:

    NAME         TYPE           CLUSTER-IP      EXTERNAL-IP                                                              PORT(S)        AGE
kubernetes   ClusterIP      10.100.0.1      <none>                                                                   443/TCP        05h
nginx        LoadBalancer   10.100.254.68   xxxxyyyyzzzz-123456789.eu-west-1.elb.amazonaws.com   80:30792/TCP   74m

    注記: このサービスは、Route 53 ホストゾーンレコードを自動的に作成します。

  3. 次のコマンドを実行してログを表示し、Route 53 レコードが正常に作成されたことを確認します。

    kubectl logs external-dns-9f85d8d5b-sx5fg

    出力例:

    ...
time="2023-12-14T17:19:19Z" level=info msg="Desired change: CREATE cname-nginx.xxxxx.people.aws.dev TXT [Id: /hostedzone/Z0786329GDVAZMXYZ]"
time="2023-12-14T17:19:19Z" level=info msg="Desired change: CREATE nginx.xxxxx.people.aws.dev A [Id: /hostedzone/Z0786329GDVAZMXYZ]"
time="2023-12-14T17:19:19Z" level=info msg="Desired change: CREATE nginx.xxxxx.people.aws.dev TXT [Id: /hostedzone/Z0786329GDVAZMXYZ]"
time="2023-12-14T17:19:20Z" level=info msg="3 record(s) in zone xxxxx.people.aws.dev. [Id: /hostedzone/Z0786329GDVAZMXYZ] were successfully updated"
...
トピック
コンテナ
タグ
Amazon Elastic Kubernetes Service
言語
日本語

関連ビデオ

詳細については、Mourya のビデオをご覧ください (4:46)
詳細については、Mourya のビデオをご覧ください (4:46)
AWS公式
AWS公式更新しました 9ヶ月前
コメントはありません

関連するコンテンツ