Bevor Sie Umgebungen konfigurieren, stellen Sie sicher, dass Ihr SCM-Anbieter verbunden ist (Enterprise Settings > Integrationen) und jeder Organisation Zugriff auf ihre Repositories gewährt wurde (Enterprise Settings > Repository-Berechtigungen). Orgs können ihrer Umgebung keine Repos hinzufügen, bis der Zugriff ausdrücklich gewährt wurde. Weitere Details finden Sie unter Git-Integrationen. +-----------------------------------------+
| Enterprise Blueprint |
| Python 3.12, Node 20, security tools |
+-----------------------------------------+
| Organization Blueprint |
| private npm registry, team linting |
+-----------------------------------------+
| Repository Blueprint |
| npm install, project-specific config |
+-----------------------------------------+
| Tier | Wer verwaltet es | Geltungsbereich |
|---|
| Enterprise | Enterprise-Admins | Alle Organisationen, alle Repositories |
| Organization | Org-Admins | Alle Repositories in der Org |
| Repository | Org-Admins oder Repo-Konfig | Ein einzelnes Repository |
Enterprise-Blueprint konfigurieren
initialize, maintenance und knowledge.
Der Enterprise-Blueprint wird bei jedem Build zuerst ausgeführt, noch vor den org- und Repo-Blueprints. Das bedeutet, dass Tools und Laufzeitumgebungen, die auf Enterprise-Ebene installiert sind, für alle nachgelagerten Blueprints verfügbar sind.
Was in den Enterprise-Blueprint gehört
Standard-Laufzeitumgebungen für Programmiersprachen
initialize:
- name: "Install Python 3.12"
uses: github.com/actions/setup-python@v5
with:
python-version: "3.12"
- name: "Install Node.js 20"
uses: github.com/actions/setup-node@v4
with:
node-version: "20"
- name: "Install Go 1.22"
uses: github.com/actions/setup-go@v5
with:
go-version: "1.22"
initialize:
- name: "Install security tools"
run: |
npm install -g snyk
pip install safety bandit
curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh
initialize:
- name: "Install internal CLI"
run: |
curl -L https://internal.example.com/cli/latest/linux-amd64 \
-o /usr/local/bin/internal-cli
chmod +x /usr/local/bin/internal-cli
Konfiguration gemeinsamer Paket-Registries
initialize:
- name: "Configure internal registries"
run: |
npm config set registry https://npm.internal.example.com/
pip config set global.index-url https://pypi.internal.example.com/simple/
Einrichtung von Unternehmens-Proxy und Zertifikaten
initialize:
- name: "Install corporate certificates"
run: |
cp "$FILE_CORPORATE_CA_CERT" /usr/local/share/ca-certificates/corporate-ca.crt
update-ca-certificates
echo 'export NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/corporate-ca.crt' >> ~/.bashrc
Wie die Ebenen zusammenwirken
1. Enterprise blueprint (runs in ~):
a. initialize
b. maintenance
2. Organization blueprint (runs in ~):
a. initialize
b. maintenance
3. Clone all repositories (up to 10 concurrent)
4. For each configured repo, in the order shown in Settings
(runs in ~/repos/<repo-name>):
a. initialize
b. maintenance
5. Health check, then snapshot is saved
knowledge-Einträge aus allen Ebenen werden gesammelt und Devin zur Verfügung gestellt. Wenn mehrere Ebenen einen knowledge-Eintrag mit demselben Namen definieren, werden alle berücksichtigt. Sie überschreiben sich nicht gegenseitig.
Enterprise-Admins können Secrets auf Enterprise-Ebene definieren. Diese Secrets stehen während jedes Builds und jeder Sitzung in allen Organisationen als Umgebungsvariablen zur Verfügung – sowohl in Blueprint-Schritten auf Enterprise-, org- als auch auf Repo-Ebene.
Verwenden Sie Enterprise-Secrets für Anmeldedaten, die im gesamten Unternehmen gemeinsam genutzt werden:
- Token für interne Package-Registries
- Authentifizierung für Unternehmens-Proxys
- Gemeinsame API-Schlüssel für interne Dienste
- Lizenzschlüssel für Enterprise-Tools
Enterprise-Secrets werden auf der Seite Unternehmensweite Einrichtung verwaltet – derselben Seite, auf der Sie auch den Enterprise-Blueprint konfigurieren. Navigieren Sie zu Settings > Devins Basisumgebung, um sowohl den Blueprint als auch die Secrets an einem Ort zu verwalten.
Zum Verwalten von Enterprise-Secrets ist die Berechtigung ManageAccountResources erforderlich.
Wenn ein org-Secret denselben Namen wie ein Enterprise-Secret hat, hat das org-Secret Vorrang. So können einzelne Organisationen bei Bedarf unternehmensweite Standardeinstellungen überschreiben.
Unternehmensweite Rebuilds
- Sie den Enterprise-Blueprint aktualisieren (z. B. Python von 3.11 auf 3.12 aktualisieren)
- Sie ein Enterprise-Secret rotieren
- Sie nach einem Sicherheitspatch alle Umgebungen aktualisieren müssen
Lösen Sie einen unternehmensweiten Rebuild unter Settings > Devins Basisumgebung aus. Der Build jeder Organisation wird mit dem aktualisierten Enterprise-Blueprint ausgeführt, gefolgt von den jeweiligen Org- und Repo-Blueprints.
Unternehmensweite Rebuilds berücksichtigen die Build-Warteschlange jeder Org. Wenn für eine Org bereits ein Build ausgeführt wird, wird der unternehmensweit ausgelöste Rebuild dahinter eingereiht. Wenn bereits ein Build in der Warteschlange steht, wird er abgebrochen
und durch den unternehmensweit ausgelösten ersetzt.
Rollout über Organisationen hinweg verwalten
