Задеплойте Verdaccio в один клик

Что такое Verdaccio?

Verdaccio — легкий приватный npm-реестр, который команды и разработчики-одиночки запускают вместо платных приватных пакетов npm, GitHub Packages или JFrog Artifactory. Вы публикуете в него пакеты через npm publish и устанавливаете их через npm, yarn или pnpm так же, как из npmjs. База данных ему не нужна: пакеты и их метаданные — это файлы на его диске.

Еще он работает как прокси публичного реестра: пакет, которого у него нет, приходит из npmjs через его uplink и сохраняется, так что следующие установки идут из Verdaccio, а не из npmjs, а скоуп вроде @yourname может оставаться приватным, пока все остальное приходит из npm. Его веб-страница показывает readme, версии и зависимости каждого пакета.

Этот шаблон запускает Verdaccio с хранилищем в томе и одним аккаунтом — именем пользователя и паролем, которые вы задаете; они записываются в его файл htpasswd при каждом запуске. Регистрация выключена, а пакеты, и ваши, и из npm, читать и устанавливать может только вошедший пользователь, так что реестр не станет открытым зеркалом для посторонних.

Хостинг Verdaccio на Pethost

1. Вы входите в Pethost — с passkey, через GitHub или Google. Машины еще нет? Вы выбираете тариф, и ссылка ждет, пока машина не будет готова.
2. Окно «Новый проект» открывается на приложении Verdaccio. Вы заполняете то, что оно просит, и нажимаете «Создать проект»: Имя пользователя, Пароль администратора.
3. Через минуту-две Verdaccio работает по своему адресу с HTTPS. Секреты создаются случайно, а данные попадают в ночной бэкап.
4. Это проект как любой другой: вы или ваш агент можете его изменить, откатить или восстановить.

Вопросы про Verdaccio

Verdaccio: файл Docker Compose

Шаблон — это этот compose.yaml и переменные, которые пишутся в .env проекта при его создании. Pethost запускает файл так, как он написан.

Контейнеры: verdaccio (verdaccio/verdaccio:6).

Тома, в ночном бэкапе: storage.

services:
  verdaccio:
    image: verdaccio/verdaccio:6
    restart: unless-stopped
    environment:
      VERDACCIO_PUBLIC_URL: ${URL}
      ADMIN_USERNAME: ${ADMIN_USERNAME}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
    # The administrator's line of the htpasswd file is written from the username and password
    # given at every start, so its password is the one in the project's .env; the other lines,
    # users the administrator added, stay as they are.
    command:
      - /bin/sh
      - -c
      - |
        node -e '
          const fs = require("node:fs");
          const bcrypt = require("/usr/local/lib/node_modules/verdaccio/node_modules/bcryptjs");
          const file = "/verdaccio/storage/htpasswd";
          const { ADMIN_USERNAME: name, ADMIN_PASSWORD: password } = process.env;
          const lines = fs.existsSync(file) ? fs.readFileSync(file, "utf8").split("\n") : [];
          const others = lines.filter((line) => line && !line.startsWith(name + ":"));
          fs.writeFileSync(file, [...others, name + ":" + bcrypt.hashSync(password, 10)].join("\n") + "\n", { mode: 0o600 });
        ' || exit 1
        unset ADMIN_PASSWORD
        exec verdaccio --config /verdaccio/conf/config.yaml --listen http://0.0.0.0:4873
    configs:
      - source: config
        target: /verdaccio/conf/config.yaml
    volumes:
      - storage:/verdaccio/storage

configs:
  config:
    content: |
      storage: /verdaccio/storage/data
      plugins: /verdaccio/plugins
      web:
        title: Verdaccio
      auth:
        htpasswd:
          file: /verdaccio/storage/htpasswd
          # Nobody signs up with npm adduser: users are lines of the file, which the administrator adds.
          max_users: -1
      uplinks:
        npmjs:
          url: https://registry.npmjs.org/
      # Only users who signed in install or publish, so the registry is no open mirror of npm.
      packages:
        '@*/*':
          access: $$authenticated
          publish: $$authenticated
          unpublish: $$authenticated
          proxy: npmjs
        '**':
          access: $$authenticated
          publish: $$authenticated
          unpublish: $$authenticated
          proxy: npmjs
      server:
        keepAliveTimeout: 60
      middlewares:
        audit:
          enabled: true
      log:
        type: stdout
        format: pretty
        level: http

volumes:
  storage:

compose.yamlОткрыть на GitHub