Trabalho diário

Trabalhar dentro do seu espaço de trabalho

O que você encontra dentro de um espaço de trabalho em execução no code-server: o editor e suas extensões, o aplicativo e o banco de dados Archibus, registros, testes de e-mail, git e onde seus arquivos ficam.

Membros do clienteAdministradores do clienteOperadores da plataforma

Última atualização 19 de junho de 2026

Este guia é para quem abre o espaço de trabalho e faz o trabalho — membro, administrador ou operador. Qualquer pessoa com acesso a um espaço de trabalho pode abri-lo no code-server (o VS Code no navegador) e usar tudo o que está descrito abaixo. Criar e iniciar espaços de trabalho é abordado em Criar o primeiro espaço de trabalho e Gerenciar espaços de trabalho; este guia começa a partir do momento em que o editor já está aberto.

Abrir o editor

Em Meus espaços de trabalho no Console, encontre o espaço de trabalho em execução e clique em Navegador. O editor abre em uma nova aba, já apontado para a pasta de aplicativos (/home/codespace/applications). Se você preferir suas ferramentas locais, o menu adicional da linha também oferece VS Code Desktop e JetBrains Gateway — eles se conectam ao mesmo espaço de trabalho por meio de um túnel.

A primeira abertura após um início pode levar alguns segundos enquanto as extensões terminam de instalar em segundo plano.

O que já vem instalado

O editor vem configurado para o trabalho com Archibus, então você raramente precisa instalar algo por conta própria:

• Archibot — o assistente dentro do espaço de trabalho, em seu próprio painel na barra lateral. Consulte Usar o bot do espaço de trabalho.
• Um conjunto completo de ferramentas Java — suporte à linguagem, depurador, Maven e Gradle — para o código de servidor do Archibus.
• SQLTools com drivers para SQL Server e Oracle, além de um cliente de banco de dados — conecte-se ao banco de dados do espaço de trabalho e execute consultas a partir do editor.
• GitLens para histórico e blame, Docker, YAML, EditorConfig, Prettier, markdownlint.
• Rainbow CSV e um visualizador de Excel para arquivos de dados.

Você pode adicionar suas próprias extensões; elas ficam na pasta home do seu espaço de trabalho e sobrevivem a um parar/iniciar.

O aplicativo Archibus

A maioria dos espaços de trabalho Archibus executa o Tomcat com o WAR do Archibus já implantado em tomcat/webapps/archibus/. O Tomcat escuta na porta 8080.

• Abra o aplicativo em execução pelo link Tomcat na página do espaço de trabalho do Coder.
• Depois de alterar código ou configuração, reinicie o Tomcat. Use a ação Reiniciar Tomcat no espaço de trabalho, ou execute ~/tomcat-service.sh restart em um terminal. ~/tomcat-service.sh status informa se ele está no ar.
• A saída do servidor vai para ~/logs/catalina.out.

O banco de dados

Dependendo de como o espaço de trabalho foi construído, ele executa SQL Server (porta 1433) ou Oracle (porta 1521). A conexão já vem configurada na configuração do Archibus para você — você não precisa configurar credenciais manualmente. As extensões SQLTools e do cliente de banco de dados vêm pré-instaladas, e o bot pode executar consultas somente leitura para você (ele não altera dados). As configurações de projeto e de conexão ficam em WEB-INF/config/afm-projects.xml, dentro da pasta de aplicativos.

Ou peça ao bot para procurar algo — ele executa a consulta com sua ferramenta somente leitura e mostra as linhas diretamente no terminal.

Onde as coisas ficam

Alguns caminhos que vale a pena conhecer:

• /home/codespace/applications — a raiz do aplicativo Archibus na qual o editor abre.
• ~/logs — startup.log (o que foi executado quando o espaço de trabalho subiu), catalina.out (Tomcat) e mail-debug.log (e-mail de teste).
• ~/flyway — configuração de migração do banco de dados, quando o Flyway é usado.

Seu diretório home é armazenamento persistente. Ele sobrevive a um parar e um iniciar, mas uma exclusão remove o espaço de trabalho e seu disco. Para qualquer coisa que você queira manter entre espaços de trabalho — notas, evidências, rascunhos — faça commit no git ou salve no Shared Drive.

O e-mail vai para uma caixa de entrada de teste

Para que o e-mail do espaço de trabalho nunca chegue a um destinatário real, as mensagens de saída são capturadas por um servidor de depuração local em 127.0.0.1:1025. Leia o que o aplicativo “enviou” em ~/logs/mail-debug.log. Se você precisar especificamente de entrega real, defina SMTP_DEBUG_DISABLE=1 antes de iniciar o Tomcat.

O git já vem autenticado

O acesso aos repositórios (Bitbucket ou GitLab) é configurado por meio de credenciais gerenciadas, então git pull, commit e push funcionam sem que você precise colar um token. Faça commit e push como você normalmente faria. Não armazene tokens, chaves ou arquivos de credenciais no repositório nem no Shared Drive.

Guias relacionados

• Usar o bot do espaço de trabalho — inicie o Archibot no editor e coloque-o para trabalhar.
• Gerenciar espaços de trabalho — iniciar, parar, atualizar e agendar a partir do Console.
• Workspace Archibot e Shared Drive — mantenha notas e artefatos que sobrevivem a um espaço de trabalho.
• Solução de problemas — primeiros passos quando o aplicativo ou o editor parece errado.