Editor File di Configurazione

Kuboide include un editor di codice integrato che ti permette di modificare i file di configurazione dei servizi direttamente dall'interfaccia web, senza dover accedere al server via SSH.

Panoramica

L'editor utilizza Monaco Editor, lo stesso motore di Visual Studio Code, offrendoti:

  • Evidenziazione della sintassi per diversi linguaggi
  • Numerazione delle righe
  • Ricerca e sostituzione
  • Supporto per file di grandi dimensioni

Tipi di File Modificabili

Ogni servizio ha i propri file di configurazione che puoi personalizzare:

File di Configurazione Servizi

Servizio File Configurazione
PHP php.ini, php-fpm.conf, www.conf
Nginx nginx.conf, redirects.conf
MySQL mysql.cnf
MariaDB mariadb.cnf
PostgreSQL postgresql.conf
Redis redis.conf
MongoDB mongod.conf
Traefik traefik.yml, dynamic.yml
Varnish default.vcl, disabled.vcl
ProFTPD proftpd.conf
Cron cronjobs.conf
Qdrant config.yaml
N8N config.json

File Docker

Ogni servizio include anche file Docker che puoi personalizzare:

File Descrizione
Dockerfile Istruzioni per costruire l'immagine del container
docker-compose-volume.yml Configurazione dei volumi Docker
docker-compose-service.yml Configurazione del servizio Docker

Accedere all'Editor

  1. Vai alla pagina di modifica dell'ambiente
  2. Seleziona il tab del servizio che vuoi configurare (es. PHP)
  3. Nella sezione File di Configurazione, trovi la lista dei file disponibili
  4. Clicca sul pulsante Modifica accanto al file che vuoi modificare

L'editor si apre a schermo intero per offrirti il massimo spazio di lavoro.

Utilizzare l'Editor

Barra Superiore

La barra superiore dell'editor mostra:

  • Nome del file che stai modificando
  • Pulsante Ripristina: annulla tutte le modifiche e torna al contenuto originale
  • Pulsante Salva: salva le modifiche e chiude l'editor
  • Pulsante Chiudi (X): chiude l'editor

Modificare il Contenuto

  1. Clicca nell'area di testo per posizionare il cursore
  2. Modifica il contenuto come in un normale editor di codice
  3. L'evidenziazione della sintassi ti aiuta a identificare errori

Salvare le Modifiche

  1. Dopo aver modificato il file, clicca su Salva
  2. L'editor si chiude e torni al form dell'ambiente
  3. Importante: Le modifiche sono salvate nel form ma non ancora applicate
  4. Clicca su Salva nel form dell'ambiente per applicare tutte le modifiche

Attenzione: Se chiudi l'editor senza salvare, le modifiche andranno perse. Un messaggio di conferma ti avviserà prima di chiudere.

Ripristinare il Contenuto Originale

Se hai fatto modifiche che vuoi annullare:

  1. Clicca sul pulsante Ripristina nella barra superiore
  2. Il contenuto torna alla versione originale
  3. Puoi continuare a modificare o salvare

File Docker

I file Docker seguono lo stesso processo di modifica:

  1. Nel tab del servizio, scorri fino alla sezione Configurazione Docker
  2. Trovi i file: Dockerfile, docker-compose-volume.yml, docker-compose-service.yml
  3. Clicca su Modifica per aprire l'editor

Nota: Modificare i file Docker richiede conoscenze tecniche. Errori in questi file possono impedire l'avvio dei container.

Linguaggi Supportati

L'editor riconosce automaticamente il tipo di file e applica l'evidenziazione corretta:

Estensione/Tipo Linguaggio
.yml, .yaml YAML
.conf Configurazione generica
.ini INI
.vcl Varnish Configuration Language
Dockerfile Dockerfile
.cnf Configurazione database
.json JSON

Suggerimenti

  • Backup: Prima di modificare file critici, copia il contenuto originale in un file locale
  • Sintassi: Rispetta la sintassi del file (indentazione in YAML, punto e virgola in PHP, ecc.)
  • Test: Dopo aver modificato i file, verifica che i servizi si avviino correttamente
  • Documentazione: Consulta la documentazione ufficiale del servizio per capire le opzioni disponibili

Prossimi Passi