メインコンテンツまでスキップ
IntroFundamentalsObservabilitySecurityNetworkingAutomationAI/MLTroubleshooting
Switch to Essentials →

Service が Endpoint を登録していない問題

このセクションでは、Application Load Balancer (ALB) が Kubernetes Service の Endpoint を正しく登録しない理由についてトラブルシューティングを行います。ALB が正常に作成されたにもかかわらず、バックエンド Service の設定に問題があるためアプリケーションにアクセスできません。

ステップ 1: エラーの確認​

ALB を通じてアプリケーションにアクセスすると、「Backend service does not exist（バックエンド Service が存在しません）」というエラーが表示されます：

ALb-Backend-DoesNotExist

Ingress は正常に作成されたため、これは Kubernetes Ingress と Service 間の通信に問題があることを示唆しています。

ステップ 2: Service 設定の確認​

Service 設定を調べてみましょう：

~$kubectl -n ui get service/ui -o yaml


apiVersion: v1
kind: Service
metadata:
  annotations: ...
  labels:
    app.kubernetes.io/component: service
    app.kubernetes.io/created-by: eks-workshop
    app.kubernetes.io/instance: ui
    app.kubernetes.io/managed-by: Helm
    app.kubernetes.io/name: ui
    helm.sh/chart: ui-0.0.1
  name: ui
  namespace: ui
spec:
  ports:
    - name: http
      port: 80
      protocol: TCP
      targetPort: http
  selector:
    app.kubernetes.io/component: service
    app.kubernetes.io/instance: ui
    app.kubernetes.io/name: ui-app
  sessionAffinity: None
  type: ClusterIP
status:
  loadBalancer: {}


ステップ 3: Ingress 設定の確認​


次に Ingress 設定を確認します：


~$kubectl get ingress/ui -n ui -o yaml


apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    alb.ingress.kubernetes.io/healthcheck-path: /actuator/health/liveness
    alb.ingress.kubernetes.io/scheme: internet-facing
    alb.ingress.kubernetes.io/target-type: ip
    ...
  finalizers:
  - ingress.k8s.aws/resources
  generation: 1
  name: ui
  namespace: ui
  resourceVersion: "4950883"
  uid: 327b899c-405e-431b-8d67-32578435f0b9
spec:
  ingressClassName: alb
  rules:
  - http:
      paths:
      - backend:
          service:
            name: service-ui
            port:
              number: 80
        path: /
        pathType: Prefix
...


Ingress が service-ui という名前の Service を使用するように設定されていますが、実際の Service 名は ui であることに注目してください。


ステップ 4: Ingress 設定の修正​


Ingress を正しい Service 名を指すように更新しましょう：


~$kubectl kustomize ~/environment/eks-workshop/modules/troubleshooting/alb/creating-alb/fix_ingress | envsubst | kubectl apply -f -


修正後の設定は次のようになります：


spec:
  ingressClassName: alb
  rules:
    - http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: ui
                port:
                  number: 80


ステップ 5: Service Endpoint の確認​


Service 名を修正した後も、まだ 503 エラーが表示されます：


ALb-503-ERROR


これは、Service のバックエンド Endpoint に問題があることを示唆しています。Endpoint を確認してみましょう：


~$kubectl -n ui get endpoints ui
NAME   ENDPOINTS   AGE
ui     <none>     13d


Endpoint が空であることは、Service が Pod バックエンドを適切に選択していないことを示しています。


ステップ 6: Service と Pod のラベルの比較​


Deployment の Pod ラベルを調べてみましょう：


~$kubectl -n ui get deploy/ui -o yaml


apiVersion: apps/v1
kind: Deployment
metadata:
  annotations:
    ...
  name: ui
  namespace: ui
  ..
spec:
  progressDeadlineSeconds: 600
  replicas: 1
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app.kubernetes.io/component: service
      app.kubernetes.io/instance: ui
      app.kubernetes.io/name: ui
  strategy:
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      annotations:
        prometheus.io/path: /actuator/prometheus
        prometheus.io/port: "8080"
        prometheus.io/scrape: "true"
      creationTimestamp: null
      labels:
        app.kubernetes.io/component: service
        app.kubernetes.io/created-by: eks-workshop
        app.kubernetes.io/instance: ui
        app.kubernetes.io/name: ui
    spec:
      containers:
...



これを Service セレクタと比較してみましょう：


~$kubectl -n ui get svc ui -o yaml


apiVersion: v1
kind: Service
metadata:
  annotations:
    ...
  labels:
    app.kubernetes.io/component: service
    app.kubernetes.io/created-by: eks-workshop
    app.kubernetes.io/instance: ui
    app.kubernetes.io/managed-by: Helm
    app.kubernetes.io/name: ui
    helm.sh/chart: ui-0.0.1
  name: ui
  namespace: ui
  resourceVersion: "5000404"
  uid: dc832144-b2a1-41cd-b7a1-8979111da677
spec:
  ...
  selector:
    app.kubernetes.io/component: service
    app.kubernetes.io/instance: ui
    app.kubernetes.io/name: ui-app
  sessionAffinity: None
  type: ClusterIP
...


Service セレクタの app.kubernetes.io/name: ui-app が Pod ラベルの app.kubernetes.io/name: ui と一致していません。


ヒント
Service セレクタを以下のように更新することができます：
kubectl edit service <service-name> -n <namespace>
または
kubectl patch service <service-name> -n <namespace> --type='json' -p='[{"op": "replace", "path": "/spec/selector", "value": {"key1": "value1", "key2": "value2"}}]'


ステップ 7: Service セレクタの修正​


Service セレクタを Pod ラベルと一致するように更新しましょう：


~$kubectl apply -k ~/environment/eks-workshop/modules/troubleshooting/alb/creating-alb/fix_ui


修正を適用した後、ブラウザを更新してください。これで UI アプリケーションが表示されるはずです：


ALB-UI-APP


ヒント
Service と Pod の接続をトラブルシューティングする際は：
    

  1. Service セレクタが Pod ラベルと完全に一致することを常に確認する
    2. 

  2. kubectl get endpoints を使用して Pod の選択を確認する
    3. 

  3. ラベル名と値のタイプミスがないか確認する
    4. 



Service 設定の問題を修正し、ALB のトラブルシューティング演習を完了しました！お疲れ様でした。