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

Aperta Adatta ai principianti
  • Qualcosa non va?
#3,296 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
85/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
node.js
Ambito
documentation

Direzione di ricerca

La doc va probabilmente in guide/global-cli.md o guide/ci.md. Leggi questi file e il toolchain.json pubblicato per elencare i pacchetti nativi per piattaforma. Verifica quali comandi CLI locali (vp lint, vp fmt, vp check, vp run) richiedono la rete usando un registry bloccato, poi aggiungi una sezione 'offline / private registry' che copra i tre punti. Done significa che la sezione esiste e risponde alle domande sollevate.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Rust
Stelle
6.5k
Fork
297
Merge medio
20h 18m
PR unite (30g)
236

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di voidzero-dev/vite-plus

Tutte le issue di voidzero-dev/vite-plus

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.