Ruby: Distribuire in produzione

Come distribuire il tuo codice Ruby in produzione in pochi minuti

👋 Benvenuti nella documentazione di Stackhero!

Stackhero offre una soluzione Ruby cloud pronta all'uso che fornisce numerosi vantaggi, tra cui:

  • Distribuisci la tua applicazione in pochi secondi con un semplice git push.
  • Usa il tuo nome di dominio e beneficia della configurazione automatica dei certificati HTTPS per una sicurezza potenziata.
  • Goditi la tranquillità con backup automatici, aggiornamenti con un clic, e una tariffazione semplice, trasparente e prevedibile.
  • Ottieni prestazioni ottimali e una sicurezza robusta grazie a una VM privata e dedicata.

Risparmia tempo e semplificati la vita: bastano solo 5 minuti per provare la soluzione Ruby cloud hosting di Stackhero!

Stackhero Ruby cloud hosting service offre un modo potente e intuitivo per distribuire i tuoi progetti Ruby in produzione in pochi minuti.

Le caratteristiche principali includono:

  • Distribuzione con un semplice git push.
  • Dominio personalizzabile con gestione automatica dei certificati TLS (HTTPS).
  • Esecuzione su una VM dedicata e privata per la massima sicurezza e riservatezza.
  • Supporto per HTTP/2, TLS 1.3 (HTTPS), WebSockets, compressione GZIP & Brotli, ETag, accesso alle porte TCP e UDP, e altro ancora.

Prerequisiti

Per distribuire i tuoi progetti su Stackhero, l'unico requisito è avere Git installato sul tuo computer.

Per risparmiare tempo ed evitare configurazioni complesse, soprattutto se il tuo ambiente di sviluppo non è pronto, considera l'uso di Code-Hero di Stackhero.

Code-Hero è una piattaforma di sviluppo potente, intuitiva e pronta all'uso, accessibile direttamente tramite il tuo browser su qualsiasi computer, tablet o telefono. Basata su un fork di VSCode, include tutti gli strumenti essenziali per lo sviluppo, preinstallati e preconfigurati, permettendoti di iniziare a programmare immediatamente senza problemi.

<!-- ![Esempio di un'istanza Code-Hero in esecuzione direttamente nel browser](/images/docs/ruby/040_deploy/rubyInCodeHero.png) -->

Passaggi per distribuire su Stackhero

Distribuire la tua applicazione Ruby su Stackhero è semplice. Puoi seguire questi passaggi, ciascuno dei quali è dettagliato ulteriormente in questa guida:

  1. Crea un servizio Ruby su Stackhero.
  2. Aggiungi la tua chiave pubblica SSH alla configurazione del tuo servizio Ruby.
  3. Configura il comando git push sulla tua piattaforma di sviluppo.
  4. Aggiungi un Makefile al tuo progetto.
  5. Distribuisci il tuo codice in produzione.

Se incontri problemi durante la distribuzione, la documentazione "Troubleshooting" è probabile che fornisca una soluzione. Assicurati di consultare questa guida poiché può farti risparmiare tempo ed evitare frustrazioni inutili.

Configurazione del tuo servizio "Stackhero for Ruby"

Se non hai ancora avviato un servizio Stackhero for Ruby, puoi crearne uno nel tuo dashboard Stackhero. Ci vogliono solo 2 minuti.

Una volta avviato il tuo servizio Ruby, devi configurarlo aggiungendo la tua chiave pubblica SSH. Puoi individuare la tua chiave pubblica eseguendo il comando:

cat ~/.ssh/id_*.pub

Non hai ancora chiavi SSH?

Puoi crearle usando:

ssh-keygen -t ed25519

Per configurare il tuo servizio Ruby, vai al dashboard Stackhero, seleziona il tuo servizio Ruby, clicca sul pulsante "Configura" e incolla il contenuto della tua chiave pubblica nella sezione "Chiavi pubbliche SSH".

<!-- ![Esempio di configurazione di un servizio Ruby](/images/docs/ruby/040_deploy/rubyStackheroPublicKey.png) -->

Suggerimento: Puoi impostare la tua chiave pubblica SSH a livello globale in modo che i futuri servizi la includano automaticamente nella loro configurazione.

Per farlo, vai al dashboard Stackhero, clicca sulla tua foto profilo in alto a destra, seleziona "Il tuo profilo" e aggiungi la tua chiave pubblica SSH.

Configurazione del comando git push per la distribuzione

La distribuzione su Stackhero viene effettuata tramite la CLI Git con il comando git push. Questo approccio rende le distribuzioni semplici, veloci e affidabili senza richiedere strumenti aggiuntivi sul tuo computer.

Per abilitare questa funzionalità, copia e incolla il valore del comando git remote dalla pagina principale del tuo servizio nel dashboard Stackhero. Il comando appare generalmente così:

git remote add stackhero ssh://stackhero@<XXXXXX>.stackhero-network.com:222/project.git
<!-- ![Comando Git remote Ruby sul dashboard di Stackhero](/images/docs/ruby/040_deploy/rubyStackheroGitRemote.png) -->

Creazione di un Makefile per la distribuzione su Stackhero

Per distribuire il tuo codice su Stackhero, devi specificare i comandi per la tua applicazione creando un Makefile. Questo file funge da ponte tra Stackhero e la tua applicazione.

Se non sei familiare con i Makefile e il comando make, non preoccuparti. Le istruzioni seguenti ti guideranno attraverso il processo.

Crea un Makefile nella radice del tuo progetto e aggiungi il seguente contenuto:

run:
	rake assets:precompile
	rake db:migrate RAILS_ENV=production
	RAILS_ENV=production bundle exec puma -C config/puma.rb

Questo Makefile contiene tre componenti importanti:

  1. La regola run, che è obbligatoria poiché viene eseguita automaticamente da Stackhero. Non rinominarla perché serve come punto di ingresso per la tua distribuzione.
  2. I comandi eseguiti usando rake e bundle. Puoi sostituirli con i comandi appropriati per la tua applicazione se necessario.
  3. Ogni comando deve essere preceduto da un carattere di tabulazione anziché spazi. Se vedi un errore come "*** missing separator", verifica che sia usato un carattere di tabulazione.

In questo esempio, tre comandi vengono eseguiti durante la distribuzione:

  1. Gli asset come JavaScript e CSS sono precompilati nella directory public/assets.
  2. Le migrazioni del database vengono eseguite se necessario.
  3. Un server Puma si avvia per servire la tua applicazione.

Distribuzione della tua applicazione Ruby

Ora sei pronto per distribuire la tua applicazione Ruby! Per distribuire il tuo codice su Stackhero, esegui il seguente comando:

git push stackhero main

La prima volta che esegui questo comando, ti verrà chiesto di aggiungere l'impronta digitale della chiave SSH. Rispondi "yes" per continuare.

Dopo pochi secondi, la tua applicazione sarà online.

<!-- ![Esempio di distribuzione del codice Ruby su Stackhero usando il comando `git push`](/images/docs/ruby/040_deploy/rubyDeployGitPush.png) -->

Per controllare la tua applicazione distribuita, vai all'URL del sito fornito sul dashboard Stackhero. Appare generalmente come https://XXXXX.stackhero-network.com.

Congratulazioni, la tua applicazione è ora distribuita in produzione!

Incontri problemi durante la distribuzione?

Consulta la sezione Troubleshooting, dove troverai probabilmente una soluzione!

Conclusione

Questa guida ha fornito una panoramica completa e semplice su come distribuire il codice Ruby in produzione usando Stackhero. Costituisce una solida base per gestire efficacemente le distribuzioni delle tue applicazioni.

Per ampliare le tue conoscenze, considera di esplorare la documentazione "Advanced Deployment Usages". Qui imparerai come distribuire vari branch git, tag o commit specifici, e gestire più ambienti come staging e produzione. Scoprirai anche suggerimenti su come lavorare con le variabili d'ambiente e altro ancora.

Se incontri un problema durante il processo di distribuzione, la documentazione "Troubleshooting" è una risorsa inestimabile che può aiutarti a risolvere i problemi in modo efficiente e a minimizzare le frustrazioni.

Other articles for Ruby