Verdaccio representa a paz , parem a guerra, seremos amarelos / azuis ?? até que isso aconteça.
Procurando pela versão Verdaccio 6? Verifique o branch
6.x
Os plugins para av6.x
que estão hospedados nesta organização estão localizados no repositórioverdaccio/monorepo
, enquanto para anext
versão estão hospedados neste projeto./packages/plugins
.
Observe que as diretrizes de contribuição podem ser diferentes dependendo do ramo.
Verdaccio é um registro npm privado local simples e sem necessidade de configuração . Não há necessidade de um banco de dados inteiro apenas para começar! O Verdaccio vem pronto para uso com seu próprio pequeno banco de dados e a capacidade de fazer proxy de outros registros (por exemplo, npmjs.org), armazenando em cache os módulos baixados ao longo do caminho. Para aqueles que desejam ampliar seus recursos de armazenamento, o Verdaccio oferece suporte a vários plug-ins criados pela comunidade para conectar-se a serviços como o s3 da Amazon, o Google Cloud Storage ou criar seu próprio plug-in.
Node.js v18 como versão mínima necessária
Instale com npm:
npm install -g verdaccio@next
Com yarn
yarn global add verdaccio@next
Com pnpm
pnpm i -g verdaccio@next
ou
docker pull verdaccio/verdaccio:nightly-master
ou com leme gráfico oficial.
helm repo add verdaccio https://charts.verdaccio.org
helm repo update
helm install verdaccio/verdaccio
Além disso, você pode ler as Diretrizes de depuração e os exemplos do Docker para um desenvolvimento mais avançado.
Você pode desenvolver seus próprios plugins com o gerador verdaccio. A instalação do Yeoman é necessária.
npm install -g yo
npm install -g generator-verdaccio-plugin
Saiba mais aqui como desenvolver plugins. Compartilhe seus plug-ins com a comunidade.
Em nosso projeto de teste de compatibilidade, nos dedicamos a garantir que seus comandos favoritos funcionem perfeitamente em diferentes versões do npm, pnpm e Yarn. Da publicação de pacotes ao gerenciamento de dependências. Nosso objetivo é dar a você a confiança necessária para usar seu gerenciador de pacotes preferido sem problemas. Então mergulhe, confira nossa matriz e veja como seus comandos se comportam em todos os aspectos!
Aprenda ou contribua aqui
cmd | npm6 | npm7 | npm8 | npm9 | npm10 | pnpm8 | pnpm9 | pnpm10 | fio1 | fio2 | fio3 | fio4 |
---|---|---|---|---|---|---|---|---|---|---|---|---|
publicar | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
cancelar publicação | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |||||
informações | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
auditoria | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
instalar | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
depreciar | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
pingar | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
procurar | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
estrela | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
estrelas | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
tag dist | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
notas:
- O yarn search cmd existe no moderno , mas não usa o endpoint do registro de pesquisa.
- O Yarn Modern tem dois comandos info, o usado aqui é
yarn npm info
= não testado ✅ = testado ⛔ = não suportado
Verdaccio é administrado por voluntários ; ninguém está trabalhando em tempo integral nisso. Se você acha este projeto útil e gostaria de apoiar seu desenvolvimento, considere fazer uma longa doação de apoio - e seu logotipo estará nesta seção do leia-me.
Doar ??? a partir de US$ 1/mês ou apenas uma única contribuição.
Se você deseja aproveitar todos os benefícios do sistema de pacotes npm em sua empresa sem enviar todo o código ao público, use seus pacotes privados tão facilmente quanto os públicos.
Se você tiver mais de um servidor no qual deseja instalar pacotes, você pode querer usar isso para diminuir a latência (presumivelmente o "lento" npmjs.org será conectado apenas uma vez por pacote/versão) e fornecer failover limitado (se npmjs. org está fora do ar, ainda podemos encontrar algo útil no cache) ou evitar problemas como Como um desenvolvedor quebrou Node, Babel e milhares de projetos em 11 linhas de JavaScript , Muitos pacotes desapareceram repentinamente ou o Registro retorna 404 para um pacote que eu já instalado antes .
Se você usa vários registros em sua organização e precisa buscar pacotes de múltiplas fontes em um único projeto, você pode aproveitar o recurso de uplinks com Verdaccio, encadeando vários registros e buscando de um único endpoint.
Se você quiser usar uma versão modificada de algum pacote de terceiros (por exemplo, você encontrou um bug, mas o mantenedor ainda não aceitou o pull request), você pode publicar sua versão localmente com o mesmo nome. Veja em detalhes aqui.
O Verdaccio provou ser um registro leve que pode ser inicializado em alguns segundos, rápido o suficiente para qualquer CI. Muitos projetos de código aberto usam Verdaccio para testes ponta a ponta, para citar alguns exemplos, create-react-app , mozilla neutrino , pnpm , storybook , babel.js , angular-cli ou docusaurus . Você pode ler mais aqui.
Além disso, aqui estão alguns exemplos de como começar:
Nó 2022, fevereiro de 2022, online grátis
Você também pode conferir nossas palestras anteriores:
Execute em seu terminal
verdaccio
Você precisaria definir alguma configuração npm, isso é opcional.
npm set registry http://localhost:4873/
Para comandos únicos ou para evitar a configuração global do registro:
NPM_CONFIG_REGISTRY=http://localhost:4873 npm i
Agora você pode navegar até http://localhost:4873/ onde seus pacotes locais serão listados e poderão ser pesquisados.
Aviso: Verdaccio atualmente não oferece suporte ao modo cluster do PM2, executá-lo com modo cluster pode causar comportamento desconhecido.
npm adduser --registry http://localhost:4873
se você usar HTTPS, adicione informações de CA apropriadas ("nulo" significa obter lista de CA do sistema operacional)
npm set ca null
npm publish --registry http://localhost:4873
Isso solicitará credenciais de usuário que serão salvas no servidor verdaccio
.
Abaixo estão as informações mais comumente necessárias, cada aspecto do Docker e do verdaccio é documentado separadamente
docker pull verdaccio/verdaccio:nightly-master
Disponível como tags.
Para executar o contêiner do Docker:
docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio
Exemplos de Docker estão disponíveis neste repositório.
Verdaccio visa oferecer suporte a todos os recursos de um cliente npm padrão que faz sentido oferecer suporte em um repositório privado. Infelizmente, nem sempre é possível.
npm install
, npm update
, etc.) - suportadonpm publish
) - compatívelnpm unpublish
) - suportadonpm dist-tag
) - suportadanpm deprecate
) - suportadanpm adduser {newuser}
) - suportadonpm profile set password
) - suportadonpm owner
) - compatívelnpm token
) - suportadonpm search
) - compatível (cli/navegador)npm ping
) - suportadonpm star
, npm unstar
, npm stars
) - suportadonpm/yarn audit
) - suportada Se quiser reportar uma vulnerabilidade de segurança, siga os passos que definimos para você em nossa política de segurança.
Agradecemos às seguintes empresas por nos ajudarem a atingir nossos objetivos, fornecendo licenças gratuitas de código aberto. Cada empresa fornece recursos suficientes para levar este projeto adiante.
Empresa | Logotipo | Licença |
---|---|---|
JetBrains | JetBrains fornece licenças de produtos para mantenedores ativos, renováveis anualmente | |
Crowdin | Crowdin fornece plataforma para traduções | |
Pilha de navegador | BrowserStack fornece plano para executar testes ponta a ponta para a IU | |
Netlificar | Netlify oferece plano profissional para implantação de site | |
Algolia | Algolia fornece serviços de pesquisa para o site | |
Docker | Docker oferece pulls e saídas ilimitadas para todo e qualquer usuário |
Juan Picado | Ayush Sharma | Sérgio Hg |
---|---|---|
@jotadeveloper | @ayusharma_ | @sergiohgz |
Priscila Oliveira | Daniel Ruf | |
@priscilawebdev | @DanielRufde |
Você pode encontrá-los e conversar com eles no Discord, clique aqui ou siga-os no Twitter .
? Não seja tímido, adicione-se a este leia-me.
Apoie este projeto tornando-se um patrocinador. Seu logotipo aparecerá aqui com um link para seu site. [Torne-se um patrocinador]
Obrigado a todos os nossos apoiadores! [Torne-se um apoiador]
Este projeto existe graças a todas as pessoas que contribuem. [Contribuir].
Se você tiver algum problema, pode tentar as seguintes opções. Não hesite em perguntar ou verificar nosso banco de dados de problemas. Talvez alguém já tenha perguntado o que você está procurando.
Verdaccio é licenciado pelo MIT
A documentação e os logotipos do Verdaccio (excluindo os arquivos /thanks, por exemplo, .md, .png, .sketch) dentro da pasta /assets) são licenciados pela Creative Commons.