Vai al contenuto principale

Guida alla distribuzione di Devin in Azure VPC

Questa guida descrive il processo per distribuire Devin all’interno del tuo ambiente Azure Virtual Private Cloud (VPC), consentendo l’accesso alle risorse protette dal firewall aziendale.
  • Configurazione semplice (con Terraform)
  • Configurazione avanzata (manuale)

Distribuzione con Terraform (consigliata)

La distribuzione con Terraform è l’approccio consigliato per configurare Devin nella tua VPC Azure. Questo metodo automatizzato garantisce un provisioning dell’infrastruttura coerente e ripetibile, con il minimo di configurazione manuale.
Flusso di lavoro della distribuzione con Terraform

Prerequisiti

Prima di iniziare il processo di distribuzione con Terraform, assicurati di disporre di:
  • Una VPC configurata per Devin (puoi usare una VPC esistente o crearne una nuova)
  • Un account Azure con autorizzazioni per:
    • creare macchine virtuali
    • creare account di archiviazione nella tua regione
  • Un account Azure in grado di supportare istanze con almeno 70 CPU virtuali
  • Terraform (versione 1.0 o successiva) installato

Processo di distribuzione passo per passo

1

Raccogliere le informazioni sull'ambiente Azure

Raccogli le seguenti informazioni, che saranno necessarie per la configurazione di Terraform:
  • ID sottoscrizione Azure (formato GUID)
  • ID VPC (nome della Virtual Network)
  • Due nomi di subnet:
    • subnet-1
    • subnet-2
Comandi Azure CLI utili:
# Elenca le tue Virtual Network
az network vnet list --query "[].{Name:name, ResourceGroup:resourceGroup}" -o table

# Elenca le subnet in una specifica Virtual Network
az network vnet subnet list --vnet-name <your-vnet-name> --resource-group <your-resource-group> --query "[].{Name:name, AddressPrefix:addressPrefix}" -o table
2

Configurare l'accesso del firewall

  • Firewall dei dispositivi utente
  • Firewall della VPC
Assicurati che i tuoi sistemi di sicurezza endpoint (dispositivi utente che accederanno a Devin) consentano l’accesso a:
  • *.devin.ai
  • *.devinenterprise.com
  • *.devinapps.com
Configurazione del firewall Azure
3

Ottenere la configurazione Terraform e il token di autenticazione

Contatta Cognition per ricevere:
  1. Un token di autenticazione per eseguire il pull dell’immagine dell’hypervisor
  2. I file di configurazione Terraform personalizzati per il tuo ambiente
Una volta che avrai condiviso le informazioni sul tuo ambiente (dallo Step 1), ti forniremo queste risorse.
4

Eseguire lo script Terraform

Possiamo pianificare una chiamata per eseguire questo step insieme. Il processo prevede:
  1. Estrarre i file di configurazione Terraform in una directory sulla tua macchina locale:
    mkdir -p ~/devin-terraform && cd ~/devin-terraform
    # Estrai i file ricevuti da Cognition
    
  2. Inizializzare l’ambiente Terraform:
    terraform init
    
  3. Verificare le modifiche di infrastruttura pianificate:
    terraform plan
    
  4. Applicare la configurazione per effettuare il provisioning dell’infrastruttura:
    terraform apply
    
  5. Confermare le modifiche quando richiesto.
Gli script Terraform configureranno tutti i componenti necessari, incluse macchine virtuali, account di archiviazione, gruppi di sicurezza, ruoli IAM e la registrazione dell’hypervisor.
5

Avviare la prima sessione con Devin

Dopo che lo script Terraform è stato completato con successo, lavoreremo insieme per:
  1. Verificare che le risorse siano state create nel tuo portale Azure
  2. Eseguire una prima sessione con Devin per verificare la connettività ai servizi richiesti
  3. Diagnosticare e risolvere eventuali problemi con il supporto del team Cognition