Document installing and running Vite+ on machines with no internet access

Aberta Para iniciantes
  • Algo errado?
#3,296 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
85/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
node.js
Domínio
documentation

Direção de pesquisa

A documentação provavelmente vai em guide/global-cli.md ou guide/ci.md. Leia esses arquivos e o toolchain.json publicado para listar pacotes nativos por plataforma. Verifique quais comandos CLI locais (vp lint, vp fmt, vp check, vp run) precisam de rede usando um registry bloqueado, então adicione uma seção 'offline / private registry' cobrindo os três pontos. Done significa que a seção existe e responde às perguntas levantadas.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

triage: not actionable
Documentation is

Missing

Explain in Detail

Our build agents and deploy servers are Windows machines with no internet. Everything installs from a private npm registry (Verdaccio) where we mirror each package by hand, including every platform-specific native binary. So for each Vite+ upgrade we need to know exactly which packages to mirror, and whether anything reaches out to the internet at runtime.

What we worked out ourselves for 1.4.0 on win32-x64, using only the local CLI from node_modules:

  • vite-plus pulls @voidzero-dev/vite-plus-win32-x64-msvc, @oxlint/binding-win32-x64-msvc, @oxfmt/binding-win32-x64-msvc and @oxlint-tsgolint/win32-x64 through optional dependencies of vite-plus, oxlint, oxfmt and oxlint-tsgolint. @voidzero-dev/vite-plus-core adds lightningcss and the platform list again.
  • With proxies and NPM_CONFIG_REGISTRY pointed at a dead port, vp lint, vp fmt --check, vp check --no-lint and a cached vp run all worked. That's not a real isolated-network test, so we can't be sure nothing else is fetched (for example by vp test or vp create).
  • The global installer and vp env need the npm registry and Node.js downloads. NPM_CONFIG_REGISTRY and VP_NODE_DIST_MIRROR cover that. VP_LOCAL_TGZ and VP_LOCAL_BINARY look like they would allow a fully offline global install, but the docs list them as development variables.
Your Suggestion for Changes

A short "offline / private registry" section, maybe in guide/global-cli.md or guide/ci.md, that says:

  • which commands of the local CLI may touch the network, if any;
  • the native packages per platform for a release (or where to read them, e.g. a field in the published toolchain.json);
  • whether VP_LOCAL_TGZ / VP_LOCAL_BINARY are supported for offline global installs or should be avoided.
Relevant Page

https://viteplus.dev/guide/global-cli and https://viteplus.dev/guide/ci

Linguagem predominante
Rust
Estrelas
6.5k
Forks
297
Merge médio
20h 56min
PRs com merge (30d)
234

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de voidzero-dev/vite-plus

Todas as issues de voidzero-dev/vite-plus

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.