STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Instalador corporativo de desenvolvimento

Finalidade e limites

O instalador prepara estações corporativas para desenvolver e manter plugins usando o Studio e o SDK. Ele é uma ferramenta nova desta versão. Não converte uma estação em servidor operacional, não importa clientes, não instala todos os plugins e não configura ERP, dispositivos ou credenciais de produção.

O ambiente de execução completo exige Linux. As opções são Linux local, WSL2 no Windows ou uma máquina Linux acessada por Remote SSH. O VS Code pode estar no Windows; PHP, Node, MySQL e os processos do Studio devem estar no mesmo host Linux da extensão.

Fluxo recomendado dentro do VS Code

  1. Instale o Studio pelo Marketplace no host correto.
  2. Execute Preparar ambiente Linux. O terminal mostra versões, extensões ausentes e o plano de pacotes.
  3. Se houver dependências ausentes, digite INSTALAR para autorizar o apt. O instalador solicita sudo somente quando necessário. Sem confirmação ou sem terminal interativo, ele não instala pacotes.
  4. Ative a licença. Inicie o núcleo pelo Studio.
  5. A extensão provisiona o núcleo autorizado, o SDK embarcado, as dependências Workerman já presentes no pacote privado e um banco MySQL próprio.
  6. Defina a senha administrativa no primeiro acesso ao Titan. Reiniciar o ambiente preserva essa senha e seus dados locais.

O instalador usa mysql-server-core, não um serviço MySQL global. O processo do Studio usa datadir e socket privados, com rede TCP de banco desativada. Nenhuma configuração de conexão operacional é copiada.

Linux pela linha de comando

A pasta installer acompanha a extensão instalada. Exemplo, substituindo o caminho pela versão realmente instalada:

python3 /caminho/da/extensao/installer/install.py --doctor
python3 /caminho/da/extensao/installer/install.py --prepare
python3 /caminho/da/extensao/installer/install.py --install \
  --studio /caminho/da/extensao \
  --state "$HOME/.local/share/titan-corporate"

O terceiro comando mantém o runtime em primeiro plano e mostra o endereço HTTP de configuração. A chave é solicitada de forma oculta no terminal. Nesse modo CLI, tokens ficam em arquivo privado com permissão 0600, dentro do diretório 0700 da instalação; no editor é usado o SecretStorage. Não execute o runtime como root. Use Ctrl+C para encerrar somente seus processos; os dados são preservados.

O diretório de estado deve ser exclusivo por ambiente. Não aponte para dados operacionais. Não execute duas instâncias no mesmo estado. O instalador recusa iniciar sobre socket já existente.

Sistemas e versões

Componente Requisito
VS Code 1.95 ou superior
PHP 8.2 ou superior; CLI, pdo_mysql, mbstring, openssl, sodium, pcntl, posix, curl, zip e fileinfo
Node.js 22 ou superior
MySQL Servidor 8 ou superior; MariaDB não é declarado equivalente
Composer CLI disponível no host Linux
Python 3.11 ou superior para instalador e extração segura

A instalação automática de pacotes atende Debian/Ubuntu com apt. A versão Node fornecida por uma distribuição pode ser anterior a 22: nesse caso o diagnóstico falha de forma explícita; instale Node 22+ por um método corporativo aprovado e repita. Outras distribuições podem preparar as ferramentas manualmente e usar o diagnóstico.

Windows e WSL2

Execute installer/windows/Install-Titan.ps1 em PowerShell como Administrador. O script pede a confirmação INSTALAR, prepara Ubuntu 24.04 no WSL e informa quando reiniciar. A criação do usuário Linux e sua senha é feita pelo próprio WSL, sem credenciais fixas.

Depois, instale a extensão WSL da Microsoft, abra a pasta pelo comando WSL: Reopen Folder in WSL e instale o Studio no lado WSL. Execute a preparação Linux nessa janela. A primeira etapa de Windows não instala PHP no Windows nem tenta executar o banco fora do WSL.

Remote SSH

Instale a extensão Remote SSH da Microsoft e abra o host Linux autorizado. Instale o Studio no host remoto, execute preparação e ativação nessa janela. O Studio usa endereços numéricos 127.0.0.1, descobre portas livres e solicita encaminhamento ao VS Code. A porta do MySQL não é exposta. Confirme as políticas de forwarding da sua organização; não desative autenticação para contorná-las.

Caminhos e compatibilidade

A fonte principal se chama CONTINUUM. O Studio usa o mesmo nome na árvore privada e nas URLs de desenvolvimento. As URLs antigas de instalações existentes são preservadas pelo Apache, independentemente da fonte principal. A compatibilidade HTTP é independente do nome físico do diretório.

Recuperação e remoção

Antes de limpar um ambiente, pare o host e faça backup do seu estado privado. A desinstalação da extensão não elimina automaticamente bancos ou projetos. A atualização instala um núcleo verificado, mas mantém dados locais; alterações de schema de plugins precisam de testes e rollback próprios. O instalador não declara uma migração de dados segura apenas porque o servidor iniciou.

Linux com AppArmor

Em Ubuntu/Debian, o perfil do MySQL pode impedir escrita no armazenamento privado da extensão, principalmente dentro da pasta pessoal. O instalador detecta a presença do perfil e oferece autorizar o caminho de estado específico. É necessário digitar AUTORIZAR no terminal antes de executar sudo.

A regra adicionada usa o modificador owner, cobre somente aquele estado e preserva as regras existentes. O instalador faz backup do complemento local e recarrega o perfil; não desativa o AppArmor nem reinicia o banco operacional. Sem autorização, a preparação informa a pendência em vez de anunciar sucesso. Em ambientes gerenciados, o administrador pode aplicar uma política equivalente antes da instalação.