Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Cloud-Umgebungen

Erstelle, konfiguriere und teile wiederverwendbare Umgebungen für Aufgaben in Codex Cloud.

Codex Cloud führt Programmieraufgaben in der Cloud aus. So kann Codex weiterarbeiten, während dein Computer im Ruhezustand ist. Im Web, auf Mobilgeräten oder in der Desktop-App kannst du mit Codex Code bearbeiten, Befehle ausführen und Ergebnisse überprüfen.

Jede Cloud-Aufgabe läuft in einem eigenen Arbeitsbereich. Wenn die Standardumgebung verfügbar ist, kannst du starten, ohne ein Repository auszuwählen. Wenn du ein Setup für mehrere Aufgaben verwenden möchtest, wähle Umgebung erstellen. Wähle die Repositorys, Abhängigkeiten, Tools und Zugriffseinstellungen aus, die deine Aufgaben benötigen, und veröffentliche anschließend die Umgebung.

Eine Einführung findest du in der Übersicht zu Codex Cloud.

Codex Cloud (Legacy) unterstützt weiterhin Code Review sowie die Integrationen für Linear und GitHub. Wir planen, diese Version auslaufen zu lassen. Im Leitfaden zur Legacy-Version erfährst du, wie du Umgebungen für diese Workflows erstellst und verwaltest.

Eine Aufgabe in Codex Cloud starten

Wähle im Web oder in der Desktop-App Arbeiten in > Cloud. Öffne auf einem Mobilgerät Codex. Wenn die Standardumgebung in der Auswahl erscheint, wähle sie aus und beschreibe deine Aufgabe.

  • Ohne Projekt kannst du ohne Repository starten. Bitte Codex zum Beispiel, ein Skript zu schreiben und es mit Beispieldaten zu testen. Wenn die Aufgabe später vorhandenen Code benötigt, sag Codex, welches Repository es klonen soll.
  • Wenn du die Aufgabe aus einem Projekt in der Desktop-App startest, kann die Standardumgebung automatisch die Repositorys verwenden, die dem Projekt zugeordnet sind. Voraussetzung ist, dass diese auf GitHub.com gehostet werden und du dein GitHub-Konto verbunden hast. Das automatische Projekt-Setup berücksichtigt keine GitLab-Repositorys.

Unabhängig vom automatischen Projekt-Setup kannst du einer laufenden Aufgabe ein Repository hinzufügen. Bitte Codex dazu, ein Repository zu klonen, auf das die Umgebung zugreifen kann. Das geht auch, wenn du die Aufgabe auf einem Mobilgerät startest. Um ein GitLab.com-Repository über die Repository-Auswahl auszuchecken, erstelle eine wiederverwendbare Umgebung im Web oder in der Desktop-App.

Wenn du ein Setup nutzen möchtest, das du bereits vorbereitet hast oder das für dich freigegeben wurde, wähle stattdessen die veröffentlichte Umgebung aus. Verwende in einem Enterprise-Workspace eine veröffentlichte Umgebung, auf die du Zugriff hast. Admins können den Zugriff im Workspace überprüfen.

Eine Umgebung erstellen und veröffentlichen

Erstelle im Web oder in der Desktop-App eine wiederverwendbare Umgebung, wenn du Repositorys, Tools oder Zugriffseinstellungen für mehrere Aufgaben nutzen möchtest. Melde dich mit deinem ChatGPT-Konto an.

  1. Wähle in einer neuen Aufgabe Arbeiten in > Cloud, öffne Umgebung auswählen und wähle Umgebung erstellen.
  2. Wähle die Repositorys aus, die Codex auschecken soll. Verbinde GitHub, wenn du dazu aufgefordert wirst. Wenn GitLab in der Repository-Auswahl verfügbar ist, wähle deine GitLab.com-Verbindung aus und suche nach dem Repository.
  3. Wähle Loslegen. Codex analysiert die Repositorys, installiert Abhängigkeiten und Tools und testet den Workflow.
  4. Gewähre fehlende Zugriffsrechte oder ergänze Informationen, wenn Codex dich darum bittet. Du kannst auch bestimmte Versionen, Befehle oder Dienste anfordern.
  5. Prüfe den Setup-Bericht, die Konfiguration und die Dateien. Schließe offene Arbeiten ab, speichere deine Änderungen und wähle Veröffentlichen.
  6. Sobald Umgebung veröffentlicht erscheint, wähle Neue Aufgabe starten und beschreibe, was Codex tun soll.

Du kannst auch über Einstellungen > Codex Cloud > Umgebungen > Umgebung erstellen beginnen.

Beim Speichern wird die Konfiguration gesichert. Einige Einstellungen gelten sofort für das aktive Setup. Beim Veröffentlichen wird der Stand des vorbereiteten Dateisystems für neue Aufgaben festgehalten. Mit der Freigabe legst du fest, wer die Umgebung nutzen kann.

Installation und Start anpassen

Codex erkennt anhand deiner Repositorys, welche Laufzeitumgebungen, Paketversionen, Tools und Dienste du verwendest. Passe das Setup im Gespräch mit Codex an. Du brauchst dafür kein eigenes Installationsskript zu schreiben.

Codex kann das getestete Setup in zwei Feldern festhalten:

  • Installationsskript: Befehle, die Abhängigkeiten installieren und die für die Entwicklung benötigten Dateien vorbereiten.
  • Start-Skill: Anweisungen zum Starten der Dienste und zum Prüfen ihrer Betriebsbereitschaft.

Gespeicherten Stand wiederverwenden und aktualisieren

  • Neue Aufgabe in einer veröffentlichten Umgebung: Sie startet mit dem vorbereiteten Dateisystem dieser Umgebung.
  • Bestehende Aufgabe: Sie arbeitet mit ihren eigenen gespeicherten Dateien weiter, einschließlich noch nicht committeter Änderungen und installierter Tools.
  • Repository-Aktualisierung: Sie läuft automatisch im Hintergrund. Zwischengespeicherte Abhängigkeiten bleiben erhalten, ohne dass Installations- oder Startbefehle erneut ausgeführt werden.

Öffne Einstellungen > Codex Cloud > Umgebungen, um das wiederverwendbare Setup zu aktualisieren. Wähle im Menü … der Umgebung Bearbeiten. Beschreibe die Änderung und lass Codex sie vorbereiten und testen. Speichere die Änderungen und wähle Erneut veröffentlichen. Starte eine neue Aufgabe, um das aktualisierte Setup zu verwenden. Bestehende Aufgaben behalten ihren eigenen Stand.

Sichere wichtige Änderungen mit einem Commit oder speichere die benötigten Ausgaben. Der gespeicherte Stand ersetzt keine Versionsverwaltung.

Umgebungsvariablen und Netzwerk-Secrets konfigurieren

Codex erkennt Lücken in der Konfiguration und fragt nach Werten, die es nicht selbst ermitteln kann. Wähle in der Umgebungskonfiguration Verwalten neben Umgebungsvariablen oder HTTP-Secrets. Lege für jeden Wert fest, wie er bereitgestellt wird:

Konfiguration Verwendungszweck Bereitstellung
Umgebungsvariable Ein Wert, den ein Programm direkt lesen muss Programme in der Umgebung erhalten den Wert direkt.
Netzwerk-Secret Zugangsdaten für einen bestimmten HTTPS-Dienst Programme erhalten einen Platzhalter. Bei Anfragen an erlaubte Ziele ersetzt der Proxy ihn durch den tatsächlichen Wert.

Lege für Netzwerk-Secrets Schlüssel, Wert und Erlaubte Domains fest. Verwende einen Schlüssel, der sich von allen Schlüsseln direkt bereitgestellter Variablen unterscheidet. Der Proxy ersetzt den Platzhalter bei HTTPS-Anfragen über Port 443, sowohl beim Setup als auch während einer Aufgabe. Die Zugangsdaten selbst gelangen dabei weder in einen lokalen Prozess noch in eine Datei.

Wenn du Netzwerk-Secrets der Umgebung speicherst, werden ihre Ziele für den eingeschränkten Internetzugriff freigegeben. Direkt bereitgestellte Variablen und persönliche Werte fügen keine Ziele hinzu. Prüfe vor dem Testen die gespeicherte Netzwerkrichtlinie. Die Anforderungen für deinen Workspace findest du unter Agentensicherheit.

Persönliche Werte bereitstellen

Im persönlichen Tresor kannst du eigene Umgebungsvariablen und Netzwerk-Secrets für Cloud-Umgebungen in deinem Workspace speichern.

Eine freigegebene Umgebung kann Werte anfordern, die jede Person über ihr eigenes Konto bereitstellt. Wenn du die Umgebung freigibst, sehen andere, welche Werte erforderlich sind. Deine persönlichen Zugangsdaten bleiben privat.

Gib die erforderlichen Werte bei Aufforderung unter Persönliche Secrets hinzufügen ein und wähle Speichern und starten. Optionale Werte kannst du offenlassen.

So verwaltest du die Werte im Voraus:

  1. Öffne Einstellungen > Codex Cloud und wähle den Tab Persönlicher Tresor.
  2. Wähle Hinzufügen. Wähle dann Umgebungsvariable oder Netzwerk-Secret unter Typ. Gib den passenden Schlüssel und deinen Wert ein.
  3. Wähle unter Gilt für die Option Alle Umgebungen oder Ausgewählte Umgebungen und anschließend Speichern.

Eine Aufgabe erhält nur die angeforderten Werte. Ein Wert für eine bestimmte Umgebung hat Vorrang vor einem allgemeinen Standardwert. Für persönliche Netzwerk-Secrets gelten die erlaubten Ziele der Umgebung. Der Proxy ersetzt die Platzhalter auf dieselbe Weise.

Eine Umgebung in einem Enterprise-Workspace freigeben

Gib ein vorbereitetes Setup frei, damit andere in deinem Team damit eigene Aufgaben starten können:

  1. Öffne die Konfiguration der Umgebung.
  2. Wähle unter Datenschutz > Wer kann die Umgebung nutzen? deinen Workspace aus.
  3. Speichere die Änderung. Veröffentliche die Umgebung, falls du das noch nicht getan hast.

Wähle Nur ich unter Wer kann die Umgebung nutzen?, wenn die Umgebung privat bleiben soll. Jede Aufgabe hat eigene Arbeitsdateien. Wer Zugriff auf das Setup hat, erhält dadurch weder Zugriff auf fremde Aufgaben noch die Berechtigung, die Umgebung zu bearbeiten.

Prüfe vor der Freigabe die vorbereiteten Dateien und die Zugangsdaten der Umgebung. Auch Cloud-Identitäten und VPN-Verbindungen können gemeinsamen Zugriff auf Dienste ermöglichen. Welche Repositorys und persönlichen Verbindungen eine Aufgabe nutzen kann, hängt vom ausführenden Konto ab.

Codex in der Cloud verwenden regelt den Zugriff auf Aufgaben. Workspace-Umgebungen verwalten regelt, wer Umgebungen erstellen und bearbeiten kann, die für den Workspace freigegeben sind. Weitere Informationen findest du unter Rollen und Workspace-Berechtigungen.

Agentensicherheit

Die Einstellungen für den Internetzugriff einer Umgebung legen fest, welche Ziele ihre VM im öffentlichen Internet erreichen kann. Unabhängig davon kannst du die VM über die VPN-Einstellungen mit Diensten in einem privaten Netzwerk verbinden.

In Enterprise-Workspaces legen Admins unter Agentensicherheit Anforderungen für den Workspace fest. Sie betreffen das Verhalten von Agenten, den verwalteten Netzwerkzugriff bei der Ausführung und die Nutzung unterstützter Tools. Die Anforderungen gelten zusätzlich zu den Domain-Einstellungen der jeweiligen Umgebung. Unter Agentensicherheit findest du die globalen Richtlinien und erfährst, welche abweichenden Einstellungen Codex Cloud unterstützt.

Verbindungen zu Diensten herstellen

Konfiguriere den Zugriff auf die Paketregistrys, APIs und anderen Dienste, die dein Workflow benötigt:

  1. Lege in der Umgebungskonfiguration fest, wie viel Zugriff dein Workflow auf das öffentliche Internet benötigt. Aktiviere Uneingeschränkten Zugriff auf das öffentliche Internet erlauben, um alle öffentlichen Ziele zuzulassen. Dazu gehören auch die Ziele, die du über die Einstellungen für Paketmanager und zusätzliche Domains freigeben kannst. Diese spezifischeren Einstellungen sind daher deaktiviert.
  2. Um den Zugriff einzuschränken, deaktiviere Uneingeschränkten Zugriff auf das öffentliche Internet erlauben. Erlaube dann Paketmanager oder füge unter Zusätzlich erlaubte Domains einzelne Hosts hinzu. Diese Ziele bleiben auch bei eingeschränktem Internetzugriff erlaubt.
  3. Speichere die Einstellungen und teste die Dienste während des Setups. Veröffentliche die Umgebung erstmals oder erneut und prüfe den Zugriff anschließend in einer neuen Aufgabe.

Der Zugriff auf das öffentliche Internet und der VPN-Zugriff sind voneinander unabhängig. Du kannst einen oder beide nutzen. Die Einstellungen für das öffentliche Internet gelten für Verbindungen außerhalb von Tailscale, auch wenn eine Tailscale-Subnetzroute öffentliche IP-Adressen verwendet. Eine Einschränkung des öffentlichen Internetzugriffs deaktiviert das konfigurierte VPN nicht.

Die Anforderungen für deinen Workspace findest du unter Agentensicherheit. Die Freigabe eines Ziels stellt keine Zugangsdaten bereit und erteilt keine Berechtigungen für den Dienst.

Für Dienste, die über das öffentliche Internet erreichbar sind und Verbindungen anhand der Quell-IP-Adresse filtern, verwende den Feed mit IP-Adressen für ausgehende Agentenverbindungen. Gib alle veröffentlichten Adressbereiche frei, prüfe den Feed täglich und aktualisiere die Freigabeliste des Dienstes, wenn sich die Bereiche ändern. Mehrere Kundenunternehmen nutzen dieselben Adressbereiche. Behalte daher die Authentifizierung und die Berechtigungsprüfungen deines Dienstes bei.

Zugriff auf private Netzwerke (VPN)

Über eine VPN-Verbindung kannst du Cloud-Aufgaben Zugriff auf Dienste in deinem privaten Netzwerk geben. Tailscale verwendet deine privaten DNS-Einstellungen, Subnetzrouten und Zugriffsregeln. Für Ziele, die über Tailscale erreichbar sind, brauchst du keine separate IP- oder Domain-Freigabeliste für Codex. Das gilt für HTTP, HTTPS und andere TCP-Dienste.

  1. Wähle in der Umgebungskonfiguration das Stiftsymbol neben Tailscale.
  2. Gib die Zugangsdaten deines VPN-Anbieters für die Verbindung ein.
  3. Konfiguriere in Tailscale die erforderlichen Routen, DNS-Einstellungen und Zugriffsregeln so, dass die VPN-Identität der Umgebung die vorgesehenen Dienste erreichen kann.
  4. Speichere die Konfiguration und veröffentliche die Umgebung erstmals oder erneut. Starte eine neue Aufgabe und teste den Dienst.

Derzeit unterstützt Codex Cloud Tailscale als VPN-Anbieter. Aktiviere beim Erstellen eines Tailscale-Authentifizierungsschlüssels sowohl Reusable als auch Ephemeral. Mit einem wiederverwendbaren Schlüssel können die VMs neuer Cloud-Aufgaben deinem Netzwerk beitreten. Tailscale entfernt temporäre Geräte automatisch, nachdem sie offline gegangen sind. Unterstützung für weitere VPN-Anbieter ist geplant.

Private IPv4-Subnetzrouten werden unterstützt. Aufgaben können Split-DNS und MagicDNS von Tailscale nutzen, um private Dienste über ihren Hostnamen zu erreichen.

Wenn dein Dienst das interne DNS deiner Organisation nutzt, konfiguriere Split-DNS in der Tailscale-Administrationskonsole so, dass Anfragen für deine interne Domain an deinen DNS-Server gehen. Verwende den vollständig qualifizierten Hostnamen des Dienstes, zum Beispiel api.corp.example.com. Er muss sich in eine IPv4-Adresse auflösen lassen. Das Ziel muss über deine konfigurierten Tailscale-Routen erreichbar sein, und deine Tailscale-Zugriffsregeln müssen den Zugriff erlauben.

Aufgaben in einer freigegebenen Umgebung verwenden die dort konfigurierte VPN-Identität.

Verbindungen zu TCP-Diensten herstellen

Über das VPN kannst du eine Verbindung zu TCP-Diensten wie Datenbanken oder SSH herstellen. TCP-Ziele müssen IPv4-Adressen verwenden, deren Datenverkehr über Tailscale geleitet wird. Bei einem Hostnamen muss das für jede IPv4-Adresse gelten, in die er aufgelöst wird. Von der Plattform geschützte Adressen bleiben gesperrt.

TCP-Clients müssen die Verbindung über den HTTP-CONNECT-Proxy der Umgebung unter proxy:8088 herstellen, entweder direkt oder mit einem lokalen Tool zur Weiterleitung. Wenn du das Ziel über einen Hostnamen angibst, übergib ihn unverändert, damit der Proxy die DNS-Auflösung übernimmt. TCP-Tunnel fangen TLS-Verbindungen nicht ab und fügen keine Netzwerk-Secrets ein. Der Client muss die Zugangsdaten für den Dienst bereitstellen und gegebenenfalls dessen TLS-Zertifikat prüfen. Anfragen, bei denen der Proxy Platzhalter durch Netzwerk-Secrets ersetzen soll, müssen den konfigurierten HTTPS-Proxy verwenden. Die Zieldomain muss für das Secret erlaubt sein. Der Proxy ersetzt Platzhalter auf Port 443.

Wenn du die VPN-Konfiguration änderst, speichere die Änderungen und veröffentliche die Umgebung erstmals oder erneut. Ersetze bereits laufende Umgebungen, damit sie die aktualisierte VPN-Konfiguration verwenden. Starte eine neue Aufgabe und teste den Zugriff. Wenn du das VPN aus einem Entwurf entfernst, bleiben bestehende Verbindungen aktiv. Um den Zugriff zu entziehen, ersetze oder beende die betroffene Umgebung.

Mit OIDC auf Cloud-Ressourcen zugreifen

Mit OpenID Connect (OIDC) kann eine Aufgabe kurzzeitig gültige Zugangsdaten für Cloud-Ressourcen beziehen. Deine Organisation richtet eine Vertrauensbeziehung zum Cloud-Anbieter ein und erteilt der Identität die Berechtigungen, die der Workflow benötigt.

  1. Öffne in den Einstellungen der gespeicherten Umgebung Erweitert > OIDC.
  2. Wähle Hinzufügen. Wähle dann eine verfügbare Verbindung oder Verbindung erstellen… für einen unterstützten Anbieter.
  3. Gib für eine neue Verbindung die Identitätsdaten des Anbieters ein und erstelle die Verbindung. Konfiguriere beim Anbieter die Vertrauensbeziehung anhand der angezeigten Werte für Issuer, Audience und Subject oder anhand von Bedingungen für Claims. Erteile die erforderlichen Berechtigungen für die Ressourcen.
  4. Vergewissere dich, dass die Verbindung der Umgebung zugeordnet ist, und prüfe ihren Alias. Speichere die Änderungen und veröffentliche die Umgebung erstmals oder erneut.
  5. Starte eine neue Aufgabe und teste sowohl eine erlaubte als auch eine gesperrte Aktion.

Das Setup hängt vom Anbieter ab. Du kannst nur unterstützte Verbindungen zuordnen. Für den Zugriff gelten die Berechtigungen der Identität. Deine persönlichen Berechtigungen beim Anbieter werden nicht auf sie übertragen. Gib die erforderlichen Endpunkte des Anbieters und die Ziele der Dienste separat in der Netzwerkrichtlinie frei.

Wenn du die Zuordnung oder den Alias änderst, speichere die Änderungen, damit sie beim Setup gelten. Veröffentliche die Umgebung erstmals oder erneut, um die Änderungen in neuen Aufgaben zu nutzen. Änderungen an einer gemeinsam genutzten Identitätsverbindung können sich auf andere Umgebungen auswirken, die sie verwenden.

Eine Aufgabe ausführen und fortsetzen

Beschreibe dein Ziel im Chat. Codex kann Dateien bearbeiten, Befehle ausführen und die eigene Arbeit prüfen. Prüfe die Änderungen und Testergebnisse, bevor du einen Commit erstellst oder einen Pull Request öffnest.

Im Web oder auf Mobilgeräten weiterarbeiten

Wähle im Web Arbeiten in > Cloud und dann eine Umgebung. Öffne auf einem Mobilgerät Codex und wähle eine verfügbare Umgebung. Neue Umgebungen kannst du im Web oder in der Desktop-App erstellen.

Öffne dieselbe Aufgabe erneut, um die Arbeit auf einem anderen Gerät fortzusetzen. Jede neue Aufgabe startet in einem eigenen Arbeitsbereich. Aufgaben in Codex Cloud können weiterlaufen, während dein Computer im Ruhezustand ist.

Aufgaben aus Slack oder Microsoft Teams starten

Wenn die Cloud-Delegierung in deinem Enterprise-Workspace aktiviert ist, kannst du @ChatGPT in Slack oder Microsoft Teams bitten, an einem Repository zu arbeiten. Anhand des Gesprächskontexts wählt Codex eine Umgebung aus, die für deinen Workspace freigegeben ist und auf die das ausführende Konto Zugriff hat. In deinem Prompt kannst du eine bevorzugte Umgebung nennen oder weitere Anweisungen geben.

Wenn dein Workspace den Zugriff auf Codex Cloud rollenbasiert steuert, müssen für Slack sowohl das Dienstkonto des Deployments als auch die anfragende Person Zugriff auf Codex Cloud erhalten. Eine Anleitung für Admins findest du unter Codex Cloud für Slack aktivieren.

Folge den Aufforderungen, Verbindungen herzustellen und Genehmigungen zu erteilen. Prüfe anschließend das Ergebnis im Gespräch. Um die Aufgabe fortzusetzen, antworte über dasselbe verbundene Konto. Eine Anfrage von einer anderen Person im Gespräch setzt deine Aufgabe nicht automatisch fort.

Wie du den Workspace einrichtest, erfährst du unter ChatGPT in Slack und Teams verwalten. Wie du Aufgaben in Slack steuerst, beschreibt ChatGPT in Slack verwenden.

VM-Ausstattung

Jede Cloud-Aufgabe läuft in einer VM mit den folgenden Standardressourcen:

ChatGPT-Plan vCPUs Arbeitsspeicher Festplattenspeicher
Plus, Edu Plus 2 8 GiB 8 GiB
Pro, Business, Enterprise 4 16 GiB 32 GiB
Edu, Edu Pro 4 16 GiB 32 GiB

Standardmäßig lässt sich der gespeicherte VM-Zustand einer Aufgabe bis zu sieben Tage lang wiederherstellen. Die Frist läuft ab dem letzten Zeitpunkt, zu dem du einen neuen Gesprächsschritt gestartet oder die Aufgabe fortgesetzt hast.

Für Enterprise sind größere VMs und individuelle Konfigurationen verfügbar. Informationen zu verfügbaren Konfigurationen und Preisen erhältst du von deinem Account-Team bei OpenAI.

Aktuelle Einschränkungen

Die folgenden Funktionen werden in Cloud-Umgebungen derzeit noch nicht unterstützt, sind aber geplant:

  • Computernutzung
  • Selbst gehosteter GitHub Enterprise Server

Skills aus deinem Repository stehen in Cloud-Aufgaben zur Verfügung. Persönliche Skills von deinem lokalen Computer werden nicht mit Cloud-Umgebungen synchronisiert.

Probleme beim Setup und beim Zugriff zur Laufzeit beheben

Das Setup schlägt fehl oder ein benötigtes Tool fehlt

Suche im Setup-Chat nach dem fehlgeschlagenen Befehl. Bitte Codex, den Fehler zu untersuchen, ihn zu beheben und den Befehl erneut auszuführen. Beispiel: „Installiere pnpm und führe die Tests des Projekts aus.“

  • Wenn das erste Setup fehlschlägt, wähle Erneut versuchen. Codex verwendet für den neuen Versuch die Repositorys, die du in dieser Setup-Sitzung bereits ausgewählt hast.
  • Wenn du zur Fehlerbehebung Quelldateien, ein Paketmanifest oder eine Lockdatei ändern musst, nimm die Änderung in einer Programmieraufgabe vor und kehre anschließend zum Setup zurück.

Sobald Codex das Setup überprüft hat, veröffentliche die Umgebung erstmals oder erneut.

Ein Paketdownload oder eine HTTPS-Anfrage schlägt fehl

Prüfe den Zielhostnamen und die Authentifizierung getrennt voneinander:

  1. Vergewissere dich, dass die Einstellungen für den Internetzugriff der Umgebung den Host zulassen. Bei einer privaten Registry unter packages.example.com prüfst du genau diesen Hostnamen. Wenn Downloads auch über downloads.example.com laufen, musst du diesen Host ebenfalls freigeben.
  2. Prüfe die URL und die Zugangsdaten, die für den Paketmanager oder Client konfiguriert sind. Die Freigabe einer Domain erteilt keine Zugriffsberechtigung für den Dienst.
  3. Wenn die Authentifizierung ein Netzwerk-Secret verwendet, prüfe, ob das Ziel unter Erlaubte Domains für dieses Secret eingetragen ist und die Anfrage HTTPS über Port 443 verwendet.
  4. Bitte in einem Enterprise-Workspace eine Person mit Adminrechten, neben den Einstellungen der Umgebung auch die geltenden Anforderungen unter Agentensicherheit zu prüfen.

Speichere alle Konfigurationsänderungen und teste die Anfrage während des Setups. Veröffentliche die Umgebung erstmals oder erneut und prüfe den Zugriff in einer neuen Aufgabe.

Ein erforderlicher Wert fehlt oder lässt sich nicht verwenden

Prüfe, ob du den Wert an der richtigen Stelle in der Umgebungskonfiguration eingetragen hast:

  • Umgebungsvariablen: Verwende sie für Werte, die Programme direkt lesen müssen, zum Beispiel APP_MODE=development.
  • HTTP-Secrets: Verwende sie für Zugangsdaten, die an einen erlaubten HTTPS-Dienst gesendet werden, etwa ein Token für eine private Registry. Programme erhalten einen Platzhalter, den der Proxy bei passenden Anfragen durch die Zugangsdaten ersetzt. Wenn das Programm den tatsächlichen Wert lesen muss, füge ihn unter Umgebungsvariablen hinzu.

Prüfe bei einem persönlichen Wert, ob sein Schlüssel mit dem von der Umgebung angeforderten Schlüssel übereinstimmt und ob Gilt für diese Umgebung einschließt. Ein Wert für eine bestimmte Umgebung hat Vorrang vor einem allgemeinen Standardwert.

Eine Anleitung findest du unter Umgebungsvariablen und Netzwerk-Secrets konfigurieren.

Die VPN-Verbindung steht, aber ein HTTP- oder HTTPS-Dienst ist nicht erreichbar

  1. Prüfe, ob der Client den konfigurierten HTTP/HTTPS-Proxy der Umgebung verwendet. Lass beim Testen mit curl die Option --noproxy weg, damit die Anfrage über diesen Proxy läuft.
  2. Prüfe bei Tailscale-Zielen die Routen und Zugriffsregeln des VPN. Prüfe bei Zielen im öffentlichen Internet die erlaubten Domains der Umgebung.
  3. Wenn der Dienst über seine IP-Adresse erreichbar ist, aber nicht über seinen Hostnamen, prüfe die DNS-Einstellungen in Tailscale. Prüfe bei einer internen Unternehmensdomain, ob Split-DNS auf den richtigen DNS-Server verweist und ob dieser über dein Tailscale-Netzwerk erreichbar ist. Verwende den vollständig qualifizierten Hostnamen des Dienstes und vergewissere dich, dass er in eine IPv4-Adresse aufgelöst wird.

Eine Anleitung zum Einrichten der Verbindung findest du unter Zugriff auf private Netzwerke.

Eine Umgebung oder ihre Aktualisierungen sind für eine Aufgabe nicht verfügbar

Prüfe die Umgebung unter Einstellungen > Codex Cloud > Umgebungen. Ist sie als Unveröffentlicht gekennzeichnet, schließe das Setup ab und wähle Veröffentlichen, um sie für Aufgaben verfügbar zu machen.

Um eine veröffentlichte Umgebung zu ändern, wähle Bearbeiten. Lass Codex die Änderungen vorbereiten und testen und wähle anschließend Erneut veröffentlichen. Starte eine neue Aufgabe in der aktualisierten Umgebung, um das neue Setup zu verwenden. Bestehende Aufgaben behalten ihren eigenen Arbeitsstand.