OpenArch / MANUAL TÉCNICO

Instalar OpenArch CLI no Linux e Windows

Homebrew, Scoop, releases, workspace Compose, diagnóstico e migração de configuração.

Editora: Arquindex · Revisado em 06/11/2026Ler em Markdown ↗

Laboratório com Docker/Compose. Não foi iniciado um servidor OpenArch nesta revisão.

Resposta direta

Instale o CLI pelo pacote da arquitetura ou gerenciador documentado, confira a versão e execute doctor, init e up em um laboratório Docker. A versão do CLI é independente da imagem do servidor.

1. Selecionar o CLI para o sistema operacional

A release consultada do CLI é 0.4.2. Use os assets de Linux, Windows ou macOS que correspondem à arquitetura da máquina. Confira checksum e instruções de assinatura publicadas com a release.

Baixar OpenArch CLI 0.4.2 · Código e instalação

Instalação via gerenciador · Linux/macOS com Homebrew

brew install AlfrescoLabs/tap/openarch
openarch version

Instalação via gerenciador · Windows com Scoop

scoop bucket add alfrescolabs https://github.com/AlfrescoLabs/scoop-bucket
scoop install openarch
openarch version

Os gerenciadores precisam estar instalados previamente. As versões oferecidas pelo canal podem mudar; registre a saída de version. O binário do CLI sozinho não contém o servidor: ele prepara e inicia serviços Docker.

2. Conferir o host e criar o workspace

Novo laboratório · Docker e Compose disponíveis

openarch doctor
openarch init --dir openarch-lab
openarch up --dir openarch-lab
openarch status --dir openarch-lab

doctor verifica os pré-requisitos. init prepara os arquivos de composição; up inicia os serviços. O workspace contém configuração e segredos: não publique esses arquivos indiscriminadamente.

3. Confirmar o contrato da versão

Consultar ajuda estruturada e sintaxe do teste

openarch help --output json
openarch smoke-test --help

O smoke test cria e remove conteúdo sintético. Execute-o somente no laboratório após revisar sua sintaxe e destino. Depois valide autenticação, criação, leitura, pesquisa e persistência após reinício.

4. Atualizar workspaces antigos

A família 0.4 introduz schemaVersion 2. Faça backup e reveja a migração em todos os computadores que usam o workspace; CLIs até 0.3.1 não leem o formato novo.

Examinar a migração antes de aplicar

openarch migrate --help
openarch migrate --dry-run

Resultado esperado e limites

O status deve indicar ambiente saudável. Confirme a versão do servidor separadamente da versão do CLI. Upload de arquivo não comprova OCR, extração de texto ou integração com Alfresco. Teste conectores e restrições de acesso antes de usar dados de clientes.

Fontes

Release CLI 0.4.2 · Descrição das mudanças 0.3/0.4 · Manual e código do CLI

Baixar exemplo: openarch-laboratorio.txt · Trecho didático para adaptar; não é um instalador completo.