# Guida rapida: il tuo primo deploy con Vimonto Deploy

> Dalla registrazione al sito online: collega un provider cloud e Git, crea e configura un server, crea un sito dal tuo repository e fai il primo deploy.

Questa guida rapida ti porta da un nuovo account a un sito pubblicato dal tuo repository Git e raggiungibile su internet. Ci vogliono circa quindici minuti, la maggior parte dei quali passa mentre il server viene installato.

Ti serve un repository Git su GitHub, GitLab o Bitbucket, e un account su Hetzner Cloud, DigitalOcean, Vultr, Akamai, Amazon Web Services o Google Cloud oppure un tuo server con Ubuntu 24.04 pulito.

![Un tour di Vimonto Deploy: la panoramica, l'elenco dei server, un server e uno dei suoi siti](https://ops.vimonto.com/docs-media/it/tour.mp4?v=161e760d)

## Passo 1: crea il tuo account

1. Apri la pagina di registrazione e compila **Nome**, **Indirizzo email**, **Password** e **Conferma password**.
2. Fai clic su **Crea account**.
3. Conferma il tuo indirizzo email con il link che ti inviamo.

Ogni nuovo account riceve un'organizzazione propria, con il tuo nome (per esempio "Organizzazione di Sam"). Creando l'account accetti i [documenti legali](/legal), come indica il modulo sotto **Crea account**.

Dopo aver confermato il tuo indirizzo email, una breve introduzione di benvenuto ti guida in quattro passi:

1. **Benvenuto**: cosa fa Vimonto Deploy. **Salta l'introduzione** ti porta subito nell'app.
2. **Organizzazione**: dai alla tua organizzazione il nome della tua azienda o del tuo team. Puoi cambiarlo in seguito in **Impostazioni** o creare altre organizzazioni. Vedi [organizzazioni](https://ops.vimonto.com/docs/it/organization/organizations).
3. **La tua prova**: la tua prima organizzazione ottiene Premium gratis per 7 giorni, con tutte le funzioni e senza dati di pagamento. Il passo mostra quando finisce la prova e cosa viene dopo: Premium oppure il piano gratuito. Vedi [fatturazione](https://ops.vimonto.com/docs/it/organization/billing).
4. **Connetti**: le due connessioni da fare per prime, il tuo provider cloud e il tuo host Git (passi 2 e 3 qui sotto). **Collega un provider cloud** e **Collega un host Git** aprono **Impostazioni** → **Integrazioni**; **Vai alla mia dashboard** apre la panoramica.

In entrambi i casi, un breve tour ti mostra poi l'app: **Impostazioni**, **Server**, **Siti**, **Attività**, la ricerca, le notifiche e **Supporto**. Usa **Avanti** e **Indietro**, oppure i tasti freccia; **Salta il tour** o Esc lo chiude.

La panoramica di una nuova organizzazione mostra **Inizia**: una checklist che va dal collegare il tuo provider cloud al tuo primo deploy. Ogni passo si spunta da solo quando è completato, il pulsante del successivo è già pronto e **Fai il tour** mostra di nuovo il tour. La croce nasconde la checklist per quell'organizzazione; scompare anche da sola quando tutti i passi sono completati.

## Passo 2: collega un provider cloud

Salta questo passo se usi un tuo server.

1. Apri **Impostazioni** nella navigazione in alto e scegli **Integrazioni**.
2. In **Aggiungi un’integrazione**, trova Hetzner Cloud, DigitalOcean, Vultr, Akamai (Linode), Amazon Web Services o Google Cloud e fai clic su **Connetti**.
3. Per DigitalOcean e Akamai, quando è disponibile l'accesso tramite il provider, **Connetti** ti porta al provider per accedere e poi ti riporta indietro; fai clic su **Con token** per incollare invece un token. Altrimenti incolla un token del tuo provider (per AWS un ID chiave di accesso e il segreto, per Google Cloud una chiave dell'account di servizio) e fai clic su **Verifica e collega**.

L'account risulta **Funzionante** dopo la verifica del token. Lo stesso login gestisce il DNS dei domini di quell'account. I dettagli per ogni provider sono in [account cloud e DNS](https://ops.vimonto.com/docs/it/connections/server-providers).

## Passo 3: collega il tuo host Git

1. Nella stessa pagina **Integrazioni**, trova GitHub, GitLab o Bitbucket in **Aggiungi un’integrazione**.
2. Fai clic su **Connetti** e autorizza l'accesso sul tuo host Git (un host mostra **Prossimamente** finché l'accesso con esso non è stato configurato sulla piattaforma). Per un GitLab self-hosted, fai clic su **Connetti** nella scheda GitLab (self-hosted) e incolla il suo indirizzo e un personal access token.

Vimonto Deploy usa questa connessione per elencare i tuoi repository e branch, e per aggiungere una deploy key in sola lettura e un webhook di push al repository di cui fai il deploy. Vedi [account Git](https://ops.vimonto.com/docs/it/connections/source-control).

> [!TIP]
> Aggiungi la tua chiave SSH pubblica in **Impostazioni account** → **Chiavi SSH** prima di creare il server. Potrai così selezionarla nel passo successivo e accedere al server dal tuo computer. Vedi [il tuo account](https://ops.vimonto.com/docs/it/more/account#aggiungere-le-tue-chiavi-ssh-personali).

## Passo 4: crea un server

1. Vai a **Server** e fai clic su **Nuovo server**.
2. In **Provider**, scegli il tuo account cloud collegato, oppure **Server personalizzato** per una tua macchina.
3. In **Tipo**, lascia **App server** (contrassegnato come **Consigliato**). Mette Nginx, PHP, un database, Redis, Memcached e Node.js su un'unica macchina, la scelta giusta per la maggior parte delle applicazioni.
4. Scegli una **Località**, una **Dimensione**, un **Nome del server** e le versioni da installare, poi controlla e fai clic su **Crea server**.

Con un provider cloud, Vimonto Deploy crea il server nel tuo account, attende l'avvio e poi esegue il provisioning. Con un server personalizzato, ricevi un comando da eseguire come root sulla tua macchina; il provisioning parte appena il server risponde.

Il provisioning richiede qualche minuto. Puoi seguire ogni passaggio in tempo reale nella pagina del server o in **Attività**, e nel frattempo puoi lasciare la pagina: riceverai un messaggio al termine, e una notifica sotto la campanella nella barra in alto. Quando il server mostra **Attivo**, è pronto. Vedi [crea un server](https://ops.vimonto.com/docs/it/servers/create-a-server), [VPS personalizzata](https://ops.vimonto.com/docs/it/servers/custom-vps) e [provisioning](https://ops.vimonto.com/docs/it/servers/provisioning) per tutte le opzioni.

## Passo 5: crea un sito

1. Apri il server e scegli **Siti** nella barra laterale.
2. Fai clic su **Nuovo sito** e scegli con cosa è costruito il tuo sito, per esempio Laravel.
3. Scegli il **Repository** e il **Branch** di cui fare il deploy.
4. Scegli l'indirizzo. Ogni sito può ricevere un indirizzo generato su `on-deploy.link`, che funziona subito senza modifiche al DNS. Scegli **Usa un dominio personalizzato** per inserire invece un tuo dominio.
5. Per i framework che ne hanno bisogno, scegli o crea un database in **Collega un database**.
6. Fai clic su **Crea sito**.

> [!TIP]
> Il DNS del tuo dominio può essere impostato per te. Collega Cloudflare, Hetzner Cloud, DigitalOcean, Vultr, Akamai, AWS o Google Cloud in [integrazioni](https://ops.vimonto.com/docs/it/connections/integrations): Vimonto Deploy trova lì il dominio, crea i suoi record e richiede HTTPS da solo. Senza collegamento, il modulo del dominio mostra **Suggerimento: lascia a noi i record DNS** con un link per collegarne uno.

Vimonto Deploy configura il sito sul server, aggiunge una deploy key e un webhook al tuo repository e avvia subito il primo deploy. Vedi [crea un sito](https://ops.vimonto.com/docs/it/sites/create-a-site).

I tuoi siti sono elencati nella pagina **Siti** del server, e ogni sito dell'organizzazione, su tutti i suoi server, in **Siti** nella navigazione in alto.

## Passo 6: segui il primo deploy

Apri il sito e scegli **Deployment**. Il deploy in corso mostra i suoi passaggi man mano che avvengono: **Recupera codice**, **Esegui lo script di deploy**, **Metti live** e **Rimuovi le vecchie release**. Aprilo per leggere l'output di ogni passaggio. Un deploy va live solo quando tutti i passaggi sono riusciti, quindi una build non riuscita non rompe mai il tuo sito.

Quando il deploy è riuscito, apri l'indirizzo del sito. La tua applicazione è online.

Da ora in poi puoi:

- fare clic su **Fai il deploy** nell'intestazione del sito per pubblicare l'ultimo commit,
- attivare **Quick deploy** perché ogni push sul branch faccia il deploy automaticamente,
- oppure chiamare l'URL di deploy del sito, o la [API REST](https://ops.vimonto.com/docs/it/more/api), dalla tua pipeline di CI.

Vedi [deployment](https://ops.vimonto.com/docs/it/sites/deployments).

## Passo 7: completa la configurazione

- Modifica il [file di ambiente](https://ops.vimonto.com/docs/it/sites/environment) (`.env`) con le impostazioni della tua applicazione.
- Punta il tuo dominio al server e [richiedi un certificato Let's Encrypt gratuito](https://ops.vimonto.com/docs/it/sites/domains-and-ssl).
- Avvia i [queue worker e lo scheduler](https://ops.vimonto.com/docs/it/sites/queues-and-scheduler) se la tua applicazione li usa.
- Configura i [backup dei database](https://ops.vimonto.com/docs/it/servers/backups) e il [monitoraggio](https://ops.vimonto.com/docs/it/servers/monitoring).
- [Invita il tuo team](https://ops.vimonto.com/docs/it/organization/members-and-roles) e, se serve, usa i [team](https://ops.vimonto.com/docs/it/organization/teams) per limitare chi vede quali server.
- Scegli quali [notifiche](https://ops.vimonto.com/docs/it/more/notifications) vuoi ricevere, per esempio quando un deploy non riesce.

## Domande frequenti

### Quanto dura il provisioning di un server?

Di solito qualche minuto. Dipende dalla dimensione del server e dalla rapidità con cui il provider avvia la macchina. Puoi seguire ogni passaggio in **Attività** mentre è in corso.

### Posso fare il deploy senza un repository Git?

Sì, per alcuni tipi di sito. Un sito può essere creato senza repository, per esempio WordPress o phpMyAdmin, che Vimonto Deploy installa per te. Per fare il deploy del tuo codice, collega prima un host Git.

### Mi serve un mio dominio per iniziare?

No. Quando gli indirizzi generati sono disponibili, ogni sito può ricevere un indirizzo `on-deploy.link` che funziona subito. Puoi aggiungere il tuo dominio in seguito in **Domini e SSL**.
