ProxMenux/web/messages/pt/docs/monitor/dashboard/vms-lxcs-app.json

{
  "meta": {
    "title": "Separador App LXC: deteção, ligações e versões | ProxMenux",
    "description": "Descubra e registre aplicativos LXC, crie links web e, opcionalmente, rastreie versões instaladas e disponíveis."
  },
  "header": {
    "title": "Separador App LXC: deteção, ligações e versões",
    "description": "Dê a cada aplicação LXC uma identidade persistente, acesso web e dados opcionais de versão sem ligar o registo às atualizações."
  },
  "intro": {
    "p1": "A aba <strong>App</strong> registra quais aplicativos pertencem a um LXC. Um registro pode conter apenas um nome e web link, ou também incluir um detector de versão instalado e uma fonte upstream.",
    "p2": "O procedimento que altera o software configura-se no <link>separador Atualizações</link>. Guardar uma aplicação nunca executa um instalador nem atualizador.",
    "callout": "Registro, rastreamento de versões e atualização são três capacidades independentes. Qualquer um pode ser usado sem exigir os outros dois.",
    "dashboardTitle": "Desde o registo até ao lançador Apps",
    "dashboard": "Cada ligação web guardada aqui aparece também como cartão no <appsLink>separador Apps</appsLink> principal. Esta página LXC continua a ser a referência para nome, logótipo, ligações e acompanhamento de versões."
  },
  "overview": {
    "heading": "O que um registro de aplicação pode fornecer",
    "lead": "Um único registro salvo pode incluir:",
    "items": [
      "Um nome visível e um logótipo adaptado ao tema.",
      "Um ou mais links web clicáveis construídos a partir do endereço LXC, esquema e porta salva.",
      "Um detector opcional para a versão atualmente instalada dentro do LXC.",
      "Uma fonte opcional GitHub, HTTP JSON ou Docker Hub para a última versão disponível.",
      "Notificações de novas versões e preferências de inclusão no contador de atualizações por aplicação.",
      "Uma seção correspondente na aba Atualizações, mesmo quando o rastreamento de versões está desativado."
    ]
  },
  "discovery": {
    "heading": "Deteção em cache e Procurar aplicações",
    "lead": "As sugestões de aplicação fazem parte do cache modal per-LXC. A varredura inicial prepara-os em segundo plano para que a abertura da aba App possa mostrar resultados em cache imediatamente.",
    "items": [
      "Abrir a guia Aplicativo <strong>não</strong> inicia uma nova varredura de catálogo e não consulta repetidamente o LXC.",
      "<strong>Procurar aplicações</strong> executa uma nova deteção nesse LXC. Utilize após instalar software enquanto o ProxMenux já está em execução.",
      "A lista anterior permanece visível enquanto a varredura explícita é executada. Novas correspondências são adicionadas quando terminar.",
      "Se não houver novas correspondências, o resultado aparece junto às ações e <strong>Registar aplicação</strong> continua disponível para introdução manual.",
      "Salvar, remover ou restaurar um aplicativo atualiza o mesmo cache imediatamente. Iniciando ou restaurando um LXC atualiza apenas esse hóspede através de seu evento de ciclo de vida existente."
    ],
    "callout": "Uma sugestão não é um registo. Mantém-se só de leitura até premir <strong>Registar</strong> e guardar o formulário."
  },
  "registration": {
    "heading": "Registar uma aplicação",
    "lead": "Uma sugestão detectada e um registro manual usam o mesmo editor:",
    "steps": [
      "Prima <strong>Registar</strong> numa sugestão ou <strong>Registar aplicação</strong> para escolher no catálogo ou introduzir um nome personalizado.",
      "Reveja o nome e logotipo propostos pelo catálogo.",
      "Adicione os links da web necessários. Portas de escuta detectadas são oferecidas como atalhos, mas nenhuma é salva automaticamente.",
      "Deixe <strong>Acompanhar versão disponível</strong> desativado em registos só com ligações ou ative-o e reveja o detetor da versão instalada e a origem da versão disponível.",
      "Com acompanhamento ativo, utilize <strong>Testar detetor</strong> e guarde o registo.",
      "Prima <strong>Concluído</strong> após editar. App e Atualizações usam o mesmo registo atualizado em cache."
    ]
  },
  "catalog": {
    "heading": "Registo assistido por catálogo",
    "lead": "O catálogo fornece padrões, mas o registro salvo permanece editável.",
    "items": [
      "Os resultados da pesquisa podem preencher o nome canônico, logotipo e portas web comuns.",
      "Detectores de versão conhecidos são baseados em nomes de pacotes reais, binários, arquivos, distribuições Python, etiquetas OCI ou comandos em vez de uma suposição universal <code>/root/.app</code>.",
      "As sobreposições de tempo de execução verificadas têm precedência quando uma instalação usa um caminho que difere dos metadados do instalador.",
      "Marcadores Proxmox VE Helper-Scripts como <code>/root/.slug</code> continuam a ser um sinal de compatibilidade para novas instalações auxiliares, não o único detector.",
      "Cada valor proposto pode ser editado antes de salvar para cobrir instaladores oficiais e instalações manuais."
    ]
  },
  "docker": {
    "heading": "Como Docker LXCs são representados",
    "lead": "Para um LXC cuja plataforma primária é Docker, <strong>Docker</strong> é o aplicativo registrado no nível LXC.",
    "items": [
      "Uma carga de trabalho containerizada como Portainer, Frigate ou Vaultwarden não é sugerida como uma aplicação nativa independente LXC.",
      "Os serviços Docker em execução com portas TCP publicadas são propostos como ligações web opcionais no editor Docker.",
      "Cada link sugerido mostra o serviço, porta host e porta container. Apenas os links que fornecem uma interface web devem ser salvos.",
      "O logotipo Docker global é usado quando um link não tem logotipo específico. Um logotipo por-link substitui-o quando um está configurado.",
      "Após o registro do Docker, o Docker Engine e as atualizações de imagem são mostradas juntos em sua seção na aba Atualizações."
    ],
    "callout": "Esta estrutura impede que uma carga de trabalho Docker pareça um software instalado diretamente no LXC preservando links rápidos para suas interfaces."
  },
  "webLinks": {
    "heading": "Ligações Web e logotipos",
    "lead": "Os links Web funcionam com ou sem rastreamento de versões.",
    "items": [
      "Cada link armazena um esquema, porta, descrição opcional e URL de logotipo opcional.",
      "A URL exibida usa o endereço atual já detectado para o LXC; o endereço não é duplicado em cada registro de aplicativo.",
      "Um link sem seu próprio logotipo cai de volta para o logotipo de nível de aplicativo.",
      "Vários links podem representar uma interface de administração, API, UI secundária ou outro endpoint do mesmo aplicativo.",
      "Um aplicativo salvo somente para links também aparece nas Atualizações, onde um atualizador personalizado pode ser configurado mais tarde."
    ]
  },
  "tracking": {
    "heading": "Rastreamento opcional da versão",
    "lead": "O acompanhamento combina um detetor da versão instalada com uma origem opcional da versão disponível. Os dois lados são verificados separadamente.",
    "colMethod": "Método de versão instalada",
    "colUse": "Usar",
    "detectorRows": [
      {
        "method": "dpkg / apk",
        "use": "Lê a versão de pacotes instalada a partir de metadados de pacotes Debian, Ubuntu ou Alpine."
      },
      {
        "method": "binary",
        "use": "Executa um caminho binário absoluto ou um nome de comando com argumentos de versão."
      },
      {
        "method": "file + regex",
        "use": "Lê um arquivo real e extrai a versão com um grupo de captura."
      },
      {
        "method": "docker label / docker exec",
        "use": "Lê um rótulo de versão OCI ou executa um comando de versão dentro de um recipiente Docker."
      },
      {
        "method": "python distribution",
        "use": "Usa importlib.metadata através do interpretador Python selecionado."
      },
      {
        "method": "command",
        "use": "Executa um comando avançado de estilo argv sem uma shell e extrai a versão de sua saída."
      },
      {
        "method": "manual",
        "use": "Armazena uma versão inserida manualmente; ela deve ser alterada após atualizar o aplicativo."
      },
      {
        "method": "OCI image",
        "use": "Para contentores instalados por OCI manager Apps. Lê as versões da aplicação e da imagem no registo da instalação e compara o digest instalado com o publicado pelo registo de imagens. Não requer configuração."
      }
    ],
    "sourcesHeading": "Origens da versão disponível",
    "sources": [
      "<strong>GitHub repositório</strong>: última versão ou tag de um repositório público <code>owner/name</code>.",
      "<strong>HTTP JSON</strong>: um endpoint público mais um caminho pontilhado como o <code>data.version</code> ou o <code>releases[0].tag_name</code>.",
      "<strong>Docker Hub</strong>: tags versionadas filtradas por uma expressão regular. Uma pré-visualização ao vivo mostra etiquetas de correspondência reais antes do registro ser salvo.",
      "Etiquetas móveis como <code>latest</code>, <code>stable</code> ou <code>lts</code> não contêm versão. Acompanhe essas imagens por digest nas atualizações de imagens Docker."
    ],
    "regexHeading": "Escrever a expressão de captura",
    "regexLead": "A expressão regular tem de devolver a versão no <strong>primeiro grupo de captura</strong>.",
    "regexRules": [
      "Coincidir com o texto emitido pelo binário, ficheiro, comando ou origem da marca seleccionado; não adivinhar um caminho genérico.",
      "Escape os pontos literais como <code>\\.</code> para não corresponderem a caracteres arbitrários.",
      "Permita um <code>v</code> inicial apenas se a origem o puder incluir.",
      "Inclua sufixos como pré-lançamento ou revisões distro apenas quando eles são significativos para a comparação.",
      "Utilize <strong>Testar detetor</strong> antes de guardar e confirme que a versão instalada apresentada corresponde ao LXC."
    ],
    "regexExampleLead": "Captura comum de versão semântica:",
    "regexExample": "v?(\\d+\\.\\d+\\.\\d+)",
    "regexCallout": "Uma correspondência regex bem sucedida não é prova de que o caminho do detector está correto. O caminho ou pacote também deve existir na instalação real que está sendo registrada."
  },
  "updater": {
    "heading": "Rastreamento e atualização de versões são independentes",
    "lead": "O <link>separador Atualizações</link> cria uma secção de aplicação logo que um registo é guardado.",
    "items": [
      "Um registro somente de links mostra que o rastreamento de versões não está configurado, mas ainda pode receber um comando de atualização personalizado.",
      "Um aplicativo com rastreamento mas sem um método executável mostra uma mensagem neutra pedindo um comando personalizado.",
      "Um aplicativo com um wrapper Proxmox VE Helper-Scripts verificado pode usar esse updater integrado mesmo quando o registro começou a partir de um link da web.",
      "Adicionar ou editar um updater não altera o detector ou fonte upstream armazenado na aba App."
    ]
  },
  "states": {
    "heading": "Os estados da versão no cartão App",
    "colState": "Estado",
    "colDisplay": "Visualização",
    "colMeaning": "Significado",
    "rows": [
      {
        "state": "Atualização disponível",
        "display": "Versão disponível em roxo com um ícone de seta para cima",
        "meaning": "As versões instaladas e a montante diferem."
      },
      {
        "state": "Atual",
        "display": "Versões instaladas e mais recentes sem o alerta roxo",
        "meaning": "A última verificação não encontrou nenhuma versão mais recente a montante."
      },
      {
        "state": "Rastreamento pendente",
        "display": "Verificação ou estado pendente",
        "meaning": "O registro está configurado, mas ainda não completou ambas as verificações."
      },
      {
        "state": "Rastreamento desativado",
        "display": "Apenas ligações Web; nenhum bloco de comparação de versões",
        "meaning": "O registro permanece válido e ainda pode ter um updater."
      },
      {
        "state": "Erro de verificação",
        "display": "Explicação a âmbar no cartão",
        "meaning": "O estado guardado anterior continua visível enquanto é comunicado o erro do detetor ou da origem da versão disponível."
      }
    ]
  },
  "management": {
    "heading": "Gerenciar aplicativos salvos e sugeridos",
    "lead": "As ações na parte inferior da aba têm papéis distintos:",
    "items": [
      "<strong>Procurar aplicações</strong> atualiza a deteção apenas neste LXC.",
      "<strong>Registe outra aplicação</strong> abre o catálogo e o editor manual sem voltar a analisar o LXC.",
      "<strong>Editar</strong> mostra em cada cartão Remover, Verificar, notificações e Editar campos.",
      "<strong>Ocultar</strong> remove uma sugestão indesejada. As deteções ocultas podem ser restauradas na vista de registo.",
      "<strong>Verificar</strong> atualiza os dados de versão da aplicação guardada selecionada; não procura novas aplicações."
    ]
  },
  "troubleshooting": {
    "heading": "Situações comuns",
    "colProblem": "Situação",
    "colResolution": "Resolução",
    "rows": [
      {
        "problem": "O software foi instalado após o início do ProxMenux",
        "resolution": "Prima Procurar aplicações. A análise explícita atualiza as sugestões em cache desse LXC."
      },
      {
        "problem": "Nenhuma aplicação foi detectada",
        "resolution": "Registre-o manualmente. Um nome e um link web são suficientes; o rastreamento pode ser adicionado mais tarde."
      },
      {
        "problem": "O detector sugerido devolve a versão errada",
        "resolution": "Abra Editar campos, escolha o pacote, binário ou caminho de ficheiro real e teste o detetor antes de guardar."
      },
      {
        "problem": "Uma carga de trabalho Docker não é oferecida como uma aplicação LXC",
        "resolution": "Registre o Docker e adicione a interface publicada da carga de trabalho como um link web do Docker. As atualizações de imagem permanecem na seção Docker."
      },
      {
        "problem": "Um aplicativo salvo não tem botão de atualização",
        "resolution": "Abra a aba Atualizações e configure seu método de atualização. O rastreamento de versões sozinho não define como uma atualização é instalada."
      }
    ]
  },
  "figures": {
    "catalog": {
      "alt": "Catálogo de registro de aplicativos com resultados de busca, logotipos, portas e campos de detectores",
      "caption": "Metadados de catálogo aceleram o registro enquanto cada valor proposto permanece editável."
    },
    "webLinks": {
      "alt": "Cartão de aplicação LXC salvo contendo um link web clicável",
      "caption": "Um registo só com ligações é válido: o acompanhamento pode ficar desativado e o atualizador pode ser adicionado separadamente."
    },
    "tracking": {
      "alt": "Campos opcionais do detetor da versão instalada e da origem da versão disponível",
      "caption": "A detecção de versão instalada e a fonte upstream são configuradas e testadas separadamente."
    },
    "card": {
      "alt": "Cartão de aplicação salvo com versões instaladas e disponíveis, além de um link para a web",
      "caption": "O cartão combina identidade, evidência de versão e acesso à web sem executar ações de atualização desta aba."
    }
  }
}