Lavoro quotidiano
Lavorare all'interno dello spazio di lavoro
Cosa trovi all'interno di uno spazio di lavoro in esecuzione in code-server: l'editor e le sue estensioni, l'app e il database Archibus, i log, il test delle email, git e dove si trovano i tuoi file.
Ultimo aggiornamento
Questa guida è per chiunque apra lo spazio di lavoro e ci lavori: membro, amministratore o operatore. Chiunque abbia accesso a uno spazio di lavoro può aprirlo in code-server (VS Code nel browser) e usare tutto ciò che segue. La creazione e l’avvio degli spazi di lavoro sono trattati in Creare il primo spazio di lavoro e Gestire gli spazi di lavoro; questa guida riprende da dove l’editor è già aperto.
Aprire l’editor
Da I miei spazi di lavoro in Console, trova lo spazio di lavoro in esecuzione e fai clic su Browser. L’editor si apre in una nuova scheda, già posizionato sulla cartella dell’applicazione (/home/codespace/applications). Se preferisci i tuoi strumenti locali, il menu aggiuntivo della riga offre anche VS Code Desktop e JetBrains Gateway: si connettono allo stesso spazio di lavoro tramite un tunnel.
La prima apertura dopo un avvio può richiedere qualche secondo mentre le estensioni terminano l’installazione in background.
Cosa è già installato
L’editor è configurato per il lavoro con Archibus, quindi raramente devi installare qualcosa da solo:
- Archibot — l’assistente integrato nello spazio di lavoro, nel proprio pannello della barra laterale. Vedi Usare il bot dello spazio di lavoro.
- Un set completo di strumenti Java — supporto del linguaggio, debugger, Maven e Gradle — per il codice server di Archibus.
- SQLTools con i driver SQL Server e Oracle, più un client di database — connettiti al database dello spazio di lavoro ed esegui query dall’editor.
- GitLens per cronologia e blame, Docker, YAML, EditorConfig, Prettier, markdownlint.
- Rainbow CSV e un visualizzatore Excel per i file di dati.
Puoi aggiungere le tue estensioni; risiedono nella home del tuo spazio di lavoro e sopravvivono a un arresto/avvio.
L’app Archibus
La maggior parte degli spazi di lavoro Archibus esegue Tomcat con il WAR di Archibus già distribuito sotto tomcat/webapps/archibus/. Tomcat è in ascolto sulla porta 8080.
- Apri l’app in esecuzione dal link Tomcat nella pagina dello spazio di lavoro Coder.
- Dopo aver modificato codice o configurazione, riavvia Tomcat. Usa l’azione Restart Tomcat sullo spazio di lavoro, oppure esegui
~/tomcat-service.sh restartin un terminale.~/tomcat-service.sh statusti dice se è attivo. - L’output del server va in
~/logs/catalina.out.
Il database
A seconda di come è stato creato lo spazio di lavoro, esegue SQL Server (porta 1433) oppure Oracle (porta 1521). La connessione è già configurata nella configurazione di Archibus per te — non devi impostare le credenziali a mano. Le estensioni SQLTools e il client di database sono preinstallati, e il bot può eseguire query di sola lettura per te (non modificherà i dati). Le impostazioni di progetto e connessione si trovano in WEB-INF/config/afm-projects.xml sotto la cartella dell’applicazione.
Oppure chiedi al bot di cercare qualcosa — esegue la query con il suo strumento di sola lettura e mostra le righe direttamente nel terminale.
Dove si trovano le cose
Alcuni percorsi che vale la pena conoscere:
/home/codespace/applications— la radice dell’applicazione Archibus in cui si apre l’editor.~/logs—startup.log(cosa è stato eseguito all’avvio dello spazio di lavoro),catalina.out(Tomcat) email-debug.log(email di test).~/flyway— la configurazione delle migrazioni del database, quando si usa Flyway.
La tua directory home è archiviazione persistente. Sopravvive a un arresto e a un avvio, ma un’eliminazione rimuove lo spazio di lavoro e il suo disco. Per qualsiasi cosa tu voglia conservare tra gli spazi di lavoro — note, evidenze, bozze — esegui il commit su git o salvala in Shared Drive.
Le email vanno in una casella di test
Affinché le email dello spazio di lavoro non raggiungano mai un destinatario reale, la posta in uscita viene catturata da un server di debug locale su 127.0.0.1:1025. Leggi ciò che l’app ha “inviato” in ~/logs/mail-debug.log. Se ti serve specificamente la consegna reale, imposta SMTP_DEBUG_DISABLE=1 prima di avviare Tomcat.
Git è già autenticato
L’accesso al repository (Bitbucket o GitLab) è configurato tramite credenziali gestite, quindi git pull, commit e push funzionano senza che tu debba incollare un token. Esegui commit e push come faresti normalmente. Non archiviare token, chiavi o file di credenziali nel repository o in Shared Drive.
Guide correlate
- Usare il bot dello spazio di lavoro — avvia Archibot nell’editor e mettilo al lavoro.
- Gestire gli spazi di lavoro — avvia, arresta, aggiorna e pianifica da Console.
- Workspace Archibot e Shared Drive — conserva note e artefatti che sopravvivono a uno spazio di lavoro.
- Risoluzione dei problemi — primi passi quando l’app o l’editor sembrano errati.
Completato quando
- Hai uno spazio di lavoro in esecuzione e lo hai aperto nel browser.
- L'editor si carica sulla cartella delle applicazioni.
- Tomcat risponde sull'URL dell'app dello spazio di lavoro.
- L'estensione Archibot è visibile nella barra laterale.