Direkt zum Inhalt

Wie behebe ich Fehler bei der Bereitstellung von Netzwerkschnittstellen für Amazon ECS auf Fargate?

Lesedauer: 5 Minute
0

Ich möchte Fehler bei der Bereitstellung von Elastic-Netzwerkschnittstellen für Amazon Elastic Container Service (Amazon ECS) auf AWS Fargate beheben.

Kurzbeschreibung

Aus den folgenden Gründen kann es bei Fargate zu API-Problemen mit dem zugrunde liegenden Host kommen:

  • Fargate versucht, eine Netzwerkschnittstelle an die zugrunde liegende Infrastruktur anzuhängen, auf der die Aufgabe ausgeführt wird. Du erhältst die folgende Fehlermeldung: „Timeout waiting for network interface provisioning to complete.“
  • Deine Fargate-Aufgaben können nicht gestartet werden, da die Netzwerkschnittstelle während des Bereitstellungsstatus der Aufgabe nicht erstellt wurde. Du erhältst die folgende Fehlermeldung: „Network interface provision complete error timeout wait for network interface provision.“

Amazon Elastic Compute Cloud (Amazon EC2) verarbeitet die Bereitstellung der ENI asynchron. Der Bereitstellungsprozess nimmt Zeit in Anspruch. Amazon ECS verfügt über ein Timeout für den Fall, dass es zu langen Wartezeiten oder nicht gemeldeten Fehlern kommt. Es gibt Zeiten, in denen die ENI bereitgestellt wird, der Bericht jedoch erst nach dem Fehler-Timeout bei Amazon ECS eintrifft. In diesem Fall sieht Amazon ECS den gemeldeten Aufgabenfehler mit einer verwendeten ENI.

ENI-Anhangsfehler sind manchmal nicht vermeidbar. Mögliche Ursachen sind:

  • Verzögerungen bei der Amazon-EC2-Anhängung und -Ausbreitung
  • Verzögerungen bei der Aktivierung der Amazon-EC2-Instance durch AWS Systems Manager (SSM)
  • Der Fargate- oder Amazon-ECS-Agent kann keine Bestätigung an die Amazon-ECS-Steuerebene zurücksenden

Hinweis: Um zu ermitteln, ob die Erstellung der Netzwerkschnittstelle das Problem verursacht hat, erstelle manuell eine Testnetzwerkschnittstelle im selben Subnetz wie deine Fargate-Aufgabe. Du kannst auch das AWS-Servicestatus-Dashboard auf API-Probleme überprüfen.

Lösung

Die Lösung hängt davon ab, wie deine Fargate-Aufgabe gestartet wird.

Wenn die Fargate-Aufgabe Teil eines Amazon-ECS-Services ist, versucht der Amazon-ECS-Service-Scheduler automatisch, die Aufgabe erneut zu starten.

Wenn die Aufgabe durch Amazon EventBridge ausgelöst wird, validiert EventBridge nicht, ob die in der Regel definierte Aktion erfolgreich ausgeführt wurde. Wenn das Ereignis kritisch ist, implementiere einen Mechanismus, der validiert, ob die Aktion ausgeführt wurde, und es andernfalls erneut versucht.

Wenn du die Aufgabe mit der RunTask-API startest, ist der Workflow asynchron. Wenn der Workflow erfolgreich gestartet wurde, wird ein Erfolgscode zurückgegeben. Die Aufgabe zeigt nicht an, dass sie sich in einem RUNNING-Status befindet. Aufgaben, die du manuell mit der RunTask-API startest, erfordern, dass du den Start manuell wiederholst.

Um Wiederholungen mit exponentiellem Backoff und Wiederholungslogik zu automatisieren, erstelle einen AWS Step Functions-Zustandsautomaten. Weitere Informationen findest du unter Erneuter Versuch nach einem Fehler.

Erstellen eines Step-Functions-Zustandsautomaten

Hinweis: Wenn du beim Ausführen von Befehlen der AWS Command Line Interface (AWS CLI) Fehler erhältst, siehe Troubleshooting errors for the AWS CLI (Beheben von Fehlern für die AWS CLI). Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

Gehe wie folgt vor, um einen Zustandsautomaten zu erstellen, der synchron die ECS-RunTask-Operation ausführt:

  1. Öffne die AWS Step Functions-Konsole.

  2. Wähle Create state machine (Zustandsmaschine erstellen) aus.

  3. Wähle Write your workflow in code (Ihren Workflow in Code schreiben) aus.

  4. Wähle für Type (Typ) die Option Standard aus. Weitere Informationen zu den verschiedenen Workflow-Typen findest du unter Workflowtyp in Step Functions auswählen.

  5. Gib im Abschnitt Definition den folgenden Code ein:

    {
      "Comment": "A description of my state machine",
      "StartAt": "ECS RunTask",
      "States": {
        "ECS RunTask": {
          "Type": "Task",
          "Resource": "arn:aws:states:::ecs:runTask.sync",
          "Parameters": {
            "LaunchType": "FARGATE",
            "Cluster": "<ClusterARN>",
            "TaskDefinition": "<TaskDefinitionARN>",
            "NetworkConfiguration": {
              "AwsvpcConfiguration": {
                "Subnets": [<Subnets>],
                "SecurityGroups": [<SecurityGroups>],
                "AssignPublicIp": "ENABLED" | "DISABLED"
              }
            }
          },
          "Next": "Notify Success",
          "Retry": [
            {
              "ErrorEquals": [
                "States.ALL"
              ],
              "BackoffRate": 2,
              "MaxAttempts": 3,
              "IntervalSeconds": 10
            }
          ],
          "Catch": [
            {
              "ErrorEquals": [
                "States.ALL"
              ],
              "Next": "TransformData"
            }
          ]
        },
        "TransformData": {
          "Type": "Pass",
          "Next": "Notify Failure",
          "Parameters": {
            "Error.$": "$.Error",
            "Cause.$": "States.StringToJson($.Cause)"
          }
        },
        "Notify Failure": {
          "Type": "Task",
          "Resource": "arn:aws:states:::sns:publish",
    

    Hinweis: Ersetze ClusterARN durch den ARN deines Clusters. Ersetze TaskDefinitionARN durch den ARN deiner Aufgabendefinition. Ersetze Subnets durch deine Subnetz-IDs. Ersetze SecurityGroups durch deine Sicherheitsgruppen-IDs. Ersetze Topic ARN durch den ARN deines Amazon-SNS-Themas.

  6. Wähle Next (Weiter) aus.

  7. Gib für Name einen Namen für deinen Zustandsautomaten ein.

  8. Wähle eine Rolle aus, um den Zustandsautomaten und die zugehörigen Ressourcen auszuführen. Verwende eine Rolle mit der geringsten Berechtigung und füge nur die Berechtigungen hinzu, die für deine AWS Identity and Access Management (IAM)-Richtlinien erforderlich sind. Die folgenden Beispielrichtlinien enthalten nur die notwendigen Berechtigungen:

    ECS-Richtlinie:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ecs:RunTask"
          ],
          "Resource": [
            "arn:aws:ecs:*:123456789:task-definition/<TASK_DEFINITION>"
          ],
          "Condition": {
            "ArnLike": {
              "ecs:cluster": "arn:aws:ecs:*:123456789:cluster/<ECS_CLUSTER>"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": "iam:PassRole",
          "Resource": [
            "*"
          ],
          "Condition": {
            "StringLike": {
              "iam:PassedToService": "ecs-tasks.amazonaws.com"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": [
            "ecs:StopTask",
            "ecs:DescribeTasks"
          ],
          "Resource": "*"
        },
        {
          "Effect": "Allow",
          "Action": [
            "events:PutTargets",
            "events:PutRule",
            "events:DescribeRule"
          ],
          "Resource": [
            "arn:aws:events:us-east-1:123456789012:rule/StepFunctionsGetEventsForECSTaskRule"
          ]
        }
      ]
    }
    

    Hinweis: Ersetze TASK_DEFINITION durch den Namen deiner Aufgabendefinition. Ersetze ECS_CLUSTER durch deinen Clusternamen.

    Amazon SNS-Richtlinie:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "sns:Publish"
          ],
          "Resource": [
            "arn:aws:sns:us-east-1:123456789012:<TOPIC>"
          ]
        }
      ]
    }
    

    Hinweis: Ersetze TOPIC durch den Namen deines Amazon Simple Notification Service (Amazon SNS)-Themas.

    Amazon CloudWatch-Richtlinie:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "logs:CreateLogDelivery",
            "logs:GetLogDelivery",
            "logs:UpdateLogDelivery",
            "logs:DeleteLogDelivery",
            "logs:ListLogDeliveries",
            "logs:PutResourcePolicy",
            "logs:DescribeResourcePolicies",
            "logs:DescribeLogGroups"
          ],
          "Resource": "*"
        }
      ]
    }
    
  9. Um die erforderlichen CloudWatch-Protokollstreams zu erstellen, wähle eine Protokollebene aus.

  10. Wähle Create state machine (Zustandsmaschine erstellen) aus.

Integriere deine Zustandsmaschine in Amazon EventBridge

Gehe wie folgt vor:

  1. Öffne die Amazon-EventBridge-Konsole.
  2. Wähle im Navigationsbereich Rules (Regeln) aus.
  3. Wähle Create rule (Regel erstellen) aus.
  4. Wähle Schedule (Zeitplan). Um eine ereignisgesteuerte Antwort zu verwenden, wähle Event (Ereignis). Weitere Informationen findest du unter EventBridge Amazon-Event-Muster erstellen.
  5. Wähle Add target (Ziel hinzufügen).
  6. Wähle aus der Dropdown-Liste Schritt: Funktionen, Zustandsmaschine.
  7. Wähle deine Zustandsmaschine aus.
  8. Wähle eine Rolle mit den entsprechenden Berechtigungen aus, um die Zustandsmaschine auszuführen.
  9. Wähle Configure details (Details konfigurieren) und gib einen Namen und eine Beschreibung für deine Regel ein.
  10. Wähle Create rule (Regel erstellen) aus.

Ähnliche Informationen

AwsVpcConfiguration

AWS OFFICIALAktualisiert vor 8 Monaten