Impostazioni e configurazione del progetto

Autore:Lars Nyström
Aggiornato:21 ago 2025

Ogni progetto su Esadax è un’istanza astratta che rappresenta la tua applicazione o il tuo carico di lavoro, che si tratti di una distribuzione CI/CD connessa a Git, di un’app full-stack orchestrata tramite One Click Apps o di un progetto Pay-as-You-Go di breve durata.

Le impostazioni del progetto controllano il modo in cui l'applicazione viene creata, distribuita e servita, adattandosi alle esigenze specifiche di ogni tipo di progetto. Comprendere queste impostazioni consente di ottimizzare le prestazioni, semplificare i flussi di lavoro e mantenere la coerenza tra gli ambienti.


Indice dei contenuti

  1. Directory principale
  2. Preimpostazioni del framework
  3. [Impostazioni di compilazione] (./12.build-settings.mdx)
  4. [Variabili di ambiente] (./16.environment-variables.mdx)
  5. Versione di Node.js
  6. [Configura intestazioni] (./21.configure-headers.mdx)

Panoramica

Il pannello Impostazioni progetto nella tua dashboard Esadax si adatta al tipo di progetto che stai gestendo, consentendoti di configurare la tua app per la compilazione e il runtime con facilità.

Progetti CI/CD connessi a Git (stile Netlify)

  • In genere il codice sorgente risiede in un repository Git.
  • Specificare la directory root per l'origine dell'app, utile soprattutto per i repository unici o le cartelle nidificate.
  • Definisci il tuo framework predefinito (Next.js, Astro, SvelteKit, ecc.) per build ottimizzate.
  • Configurare comandi di compilazione e cartelle di output.
  • Gestire variabili di ambiente per diverse fasi di distribuzione.
  • Seleziona le versioni di Node.js per build e runtime di funzioni serverless.
  • Personalizza le intestazioni HTTP per caching, sicurezza e prestazioni.

Applicazioni One Click e progetti Pay-as-You-Go (Full-Stack e a breve termine)

  • Project si basa su carichi di lavoro containerizzati o orchestrati.
  • Non è richiesta alcuna directory root Git tradizionale.
  • Concentrati sull'impostazione di nome progetto e sulla definizione delle necessarie variabili di ambiente (ad esempio, credenziali, URL di servizio).
  • Distribuisci rapidamente senza passaggi di compilazione complessi.
  • La configurazione runtime è fondamentale: tutte le variabili di ambiente vengono passate direttamente ai container o ai servizi orchestrati.
  • I progetti Pay-as-You-Go consentono il controllo di avvio/arresto con fatturazione basata sul tempo di esecuzione attivo.

Directory principale

Per i progetti connessi a Git, in particolare quelli che utilizzano monorepos, specificare la directory principale è essenziale per individuare correttamente il codice sorgente dell’applicazione.

I progetti One Click Apps e Pay-as-You-Go non richiedono un'impostazione della directory principale poiché l'applicazione viene distribuita tramite immagini container o servizi orchestrati.

Per ulteriori informazioni, vedere Impostazioni directory principale.


Preimpostazioni del framework

I predefiniti del framework ottimizzano le fasi di compilazione e distribuzione in base alla tecnologia di frontend. Questo è principalmente per i progetti CI/CD connessi a Git.

I progetti One Click Apps e Pay-as-You-Go in genere non richiedono preimpostazioni del framework, poiché si basano su immagini container precostituite.

Vedere Preimpostazioni framework per i dettagli.


Impostazioni di build

Personalizza i comandi di compilazione, le cartelle di output e i passaggi di installazione per i progetti basati su sorgente utilizzando le pipeline CI/CD.

Per i progetti basati su container, il processo di compilazione avviene al di fuori di Esadax, quindi le impostazioni di compilazione generalmente non sono applicabili.

Maggiori informazioni in Impostazioni di compilazione.


Variabili di ambiente

Le variabili di ambiente sono vitali per tutti i tipi di progetto:

  • Per i progetti connessi a Git, definisci variabili con ambito per gli ambienti di compilazione e runtime.
  • Per One Click Apps e Pay-as-You-Go, le variabili di ambiente configurano i servizi containerizzati e il comportamento di runtime.

Gestiscili in modo sicuro tramite dashboard o CLI. Scopri come fare in Variabili di ambiente.


Versione di Node.js

Configura la versione runtime di Node.js per build e funzioni serverless nei progetti connessi a Git.

Non applicabile ai progetti One Click Apps o Pay-as-You-Go orchestrati da container, a meno che i container non specifichino internamente le versioni di Node.js.

Vedere Configura versione Node.js.


Configura intestazioni

Imposta intestazioni HTTP personalizzate per le politiche di caching, i miglioramenti della sicurezza e i controlli di routing — per lo più rilevanti per i progetti frontend distribuiti tramite Git.

One Click Apps può supportare le intestazioni in base alla configurazione del contenitore o del servizio, ma questo varia a seconda dell'app.

Per ulteriori informazioni, vedere Configura intestazioni.


Conclusione

Le impostazioni del progetto in Esadax sono progettate per supportare in modo flessibile il tuo stile di distribuzione, dai flussi di lavoro CI/CD completamente integrati con Git alle app full-stack basate su container istantanei e alle distribuzioni pay-as-you-go convenienti.

Personalizza la configurazione del progetto in base all'architettura sottostante per massimizzare l'efficienza, il controllo e l'affidabilità.

Esplora le guide collegate per ogni impostazione per mettere a punto i tuoi progetti e sbloccare il pieno potenziale della piattaforma di Esadax.