first commit

2026-04-02 11:30:12 +03:00
commit 0270f4e360
1 changed files with 89 additions and 0 deletions
@@ -0,0 +1,89 @@
+# Обзор
+
+Реестр пакетов может использоваться как общедоступный или частный реестр для распространённых менеджеров пакетов.
+
+## Поддерживаемые менеджеры пакетов
+
+В настоящее время поддерживаются следующие менеджеры пакетов:
+
+| Название  | Язык       | Клиент пакетов               |
+| --------- | ---------- | ---------------------------- |
+| Alpine    | -          | apk                          |
+| Arch      | -          | pacman                       |
+| Cargo     | Rust       | cargo                        |
+| Chef      | -          | knife                        |
+| Composer  | PHP        | composer                     |
+| Conan     | C++        | conan                        |
+| Conda     | -          | conda                        |
+| Container | -          | любой OCI-совместимый клиент |
+| CRAN      | R          | -                            |
+| Debian    | -          | apt                          |
+| Generic   | -          | любой HTTP-клиент            |
+| Go        | Go         | go                           |
+| Helm      | -          | любой HTTP-клиент, cm-push   |
+| Maven     | Java       | mvn, gradle                  |
+| npm       | JavaScript | npm, yarn, pnpm              |
+| NuGet     | .NET       | nuget                        |
+| Pub       | Dart       | dart, flutter                |
+| PyPI      | Python     | pip, twine                   |
+| RPM       | -          | yum, dnf, zypper             |
+| RubyGems  | Ruby       | gem, Bundler                 |
+| Swift     | Swift      | swift                        |
+| Vagrant   | -          | vagrant                      |
+
+Следующие абзацы применяются только если пакеты не отключены глобально!
+
+## Пакеты репозитория
+
+Пакет всегда принадлежит владельцу (пользователю или организации), а не репозиторию. Чтобы привязать (уже загруженный) пакет к репозиторию, откройте страницу настроек этого пакета и выберите репозиторий для привязки. Будет привязан весь пакет, а не только отдельная версия.
+
+Привязка пакета приводит к тому, что этот пакет отображается в списке пакетов репозитория, а на сайте пакета показывается ссылка на репозиторий (а также ссылка на задачи репозитория).
+
+## Ограничения доступа
+
+| Тип владельца пакета | Пользователь                                                                                          | Организация                                                                                     |
+| -------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| доступ на чтение     | общедоступный, если пользователь тоже общедоступный; в противном случае только для этого пользователя | общедоступный, если организация общедоступная; в противном случае только для членов организации |
+| доступ на запись     | только владелец                                                                                       | члены организации с правами администратора или записи в организацию                             |
+
+**Примечание:** Эти ограничения доступа могут измениться, где будет добавлено более детальное управление через специальное разрешение команды организации.
+
+## Создание или загрузка пакета
+
+В зависимости от типа пакета используйте соответствующий менеджер пакетов. Ознакомьтесь с подстраницей конкретного менеджера пакетов для получения инструкций.
+
+## Просмотр пакетов
+
+Вы можете просматривать пакеты репозитория на странице репозитория.
+
+1. Перейдите к репозиторию.
+2. Перейдите к "Пакетам" в навигационной панели.
+
+Чтобы просмотреть более подробную информацию о пакете, выберите название пакета.
+
+## Загрузка пакета
+
+Чтобы загрузить пакет из вашего репозитория:
+
+1. Перейдите к "Пакетам" в навигационной панели.
+2. Выберите название пакета для просмотра деталей.
+3. В разделе "Ресурсы" выберите название файла пакета, который вы хотите загрузить.
+
+## Удаление пакета
+
+Вы не можете редактировать пакет после его публикации в Реестре пакетов. Вместо этого вы должны удалить и воссоздать его.
+
+Чтобы удалить пакет из вашего репозитория:
+
+1. Перейдите к "Пакетам" в навигационной панели.
+2. Выберите название пакета для просмотра деталей.
+3. Нажмите "Удалить пакет", чтобы окончательно удалить пакет.
+
+## Отключение Реестра пакетов
+
+Реестр пакетов включен автоматически. Чтобы отключить его для отдельного репозитория:
+
+1. Перейдите к "Настройкам" в навигационной панели.
+2. Отключите "Включить реестр пакетов репозитория".
+
+Ранее опубликованные пакеты не удаляются при отключении Реестра пакетов.