FAQ

Wir möchten unseren Kunden die Informationen geben, die sie benötigen, um STACKIT Workflows optimal zu nutzen. Dieser FAQ-Bereich beantwortet häufig gestellte Fragen. Dies hilft Ihnen, schnell Lösungen zu finden und Ihre Erfahrung zu verbessern. Wir empfehlen Ihnen, diese FAQ zu lesen, bevor Sie unser Support-Team kontaktieren, da Sie hier eventuell bereits Ihre Antwort finden.

• Allgemeine Informationen

  Alle erweitern

  Wie kann ich Images aus einer privaten Registry mit STACKIT Workflows verwenden?

  Bitte eröffnen Sie ein Support-Ticket für Unterstützung. Wichtig: Geben Sie aus Sicherheitsgründen keine Zugangsdaten oder Secrets in Ihrer ersten Nachricht an. Wir werden diese Informationen bei Bedarf über einen sicheren Kanal anfordern.

  Wie erhöhe ich die Größe meines STACKIT Workflows-Clusters?

  Bei dieser Frage geht es um die Dimensionierung der Workflows-Infrastruktur (Webserver, Scheduler, Trigger), nicht um die maximale Ressourcennutzung von DAGs (siehe unten). Dies ist derzeit über das STACKIT Portal nicht möglich. Bitte öffnen Sie ein Support-Ticket und machen Sie Angaben zu Ihrem Anwendungsfall, damit das STACKIT Engineering Sie bei der Bestimmung der richtigen Cluster-Größe unterstützen kann.

  DAGs schlagen mit der Fehlermeldung „[...] forbidden: exceeded quota: airflow-worker-quota [...]“ fehl. Was kann ich tun?

  Die Fehlermeldung weist darauf hin, dass Ihre DAGs mehr CPU und/oder Speicher anfordern als zulässig ist. Bitte öffnen Sie ein Support-Ticket und beantragen Sie eine Erhöhung Ihres Kontingents.

  Mein Identitätsanbieter wird nicht unterstützt. Was kann ich tun?

  STACKIT Workflows verwendet das OpenID Connect-Protokoll für die Interaktion mit Identitätsanbietern. Wenn Ihr Anbieter OpenID Connect unterstützt, aber nicht als unterstützter Anbieter aufgeführt ist, öffnen Sie bitte ein Support-Ticket.

  How can I use secrets from STACKIT Secrets Manager in my Workflows instance?

  Currently there is no out-of-the-box integration between STACKIT Secrets Manager and STACKIT Workflows. However, you can still use Secrets Manager by integrating it yourself via the Secrets Manager REST API.

  Currently there is no out-of-the-box integration between STACKIT Secrets Manager and STACKIT Workflows. However, you can still use Secrets Manager by integrating it yourself via the Secrets Manager REST API.

  A common approach is to implement a custom vault client that calls the Secrets Manager API and use it inside your DAGs. The credentials required to access Secrets Manager can be stored securely as an Airflow Connection in your Workflows instance.

  The client can then be used in two typical ways:

  1. Runtime retrieval in DAGs

  The client fetches secrets directly during DAG task instance processing when processing data.

  2. Synchronization DAG

  A dedicated DAG periodically retrieves secrets from Secrets Manager and synchronizes them, for example by:

  • creating Kubernetes Secrets, or
  • creating Airflow Connections via the Airflow API

  With the second approach, the synchronized secrets can then be used as parameters for operators within your workflows.

  Creating the secret as Kubernetes secret could be implemented in a similar way as the following:

  from kubernetes import client, config
  from kubernetes.client.rest import ApiException
  
  secret = client.V1Secret(
          metadata=client.V1ObjectMeta(name=name, labels=labels or {}),
          type="Opaque",
          data=<encoded_secret>,
      )
  
      try:
          v1.create_namespaced_secret(namespace=namespace, body=secret)
      except ApiException as e:
          if e.status == 409:
              v1.patch_namespaced_secret(name=name, namespace=namespace, body=secret)
          else:
              raise

  The secret can then be used in worker pods either by mounting it to the KubernetesPodOperator or by reading it using Python functions.

• Bekannte Probleme

  Alle erweitern

  DAG-Importfehler bleibt nach Löschen des DAG bestehen

  Dies ist ein bekannter Fehler von Airflow. Wenn ein DAG in den Fehlerzustand übergeht, wird dieser Fehlerzustand nicht entfernt, wenn der DAG selbst nicht mehr geladen wird. Sie können einen gültigen Dummy-DAG mit demselben Namen/Pfad neu erstellen. Dadurch wird das Problem behoben. Löschen Sie den DAG anschließend wieder.

  Airflow-Task-Logs

  Wenn Sie Logs über die Benutzeroberfläche von STACKIT Workflows untersuchen, wird möglicherweise eine Fehlermeldung wie die folgende angezeigt. Bitte ignorieren Sie den Fehler einfach – es fehlen keine Logs und der Fehler wird nicht durch Ihren Code verursacht. Dies ist ein bekanntes Problem und wird in einer zukünftigen Version behoben.

  [2025-05-26, 16:53:59 UTC] {pod_manager.py:505} ERROR - Reading of logs interrupted for container 'base'; will retry.
  Traceback (most recent call last):
    File "/home/airflow/.local/lib/python3.12/site-packages/airflow/providers/cncf/kubernetes/utils/pod_manager.py", line 459, in consume_logs
      for raw_line in logs:
                      ^^^^
    File "/home/airflow/.local/lib/python3.12/site-packages/airflow/providers/cncf/kubernetes/utils/pod_manager.py", line 263, in __iter__
      for data_chunk in self.response.stream(amt=None, decode_content=True):
                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/home/airflow/.local/lib/python3.12/site-packages/urllib3/response.py", line 1063, in stream
      yield from self.read_chunked(amt, decode_content=decode_content)
    File "/home/airflow/.local/lib/python3.12/site-packages/urllib3/response.py", line 1219, in read_chunked
      self._update_chunk_length()
    File "/home/airflow/.local/lib/python3.12/site-packages/urllib3/response.py", line 1149, in _update_chunk_length
      raise ProtocolError("Response ended prematurely") from None
  urllib3.exceptions.ProtocolError: Response ended prematurely