🗂️ Создание своего registry

Registry ASC — это статический JSON: registry.json ссылается на индексы категорий, а каждая категория перечисляет пакеты.

my-registry/
├── registry.json
└── categories/web.json

// registry.json
{
  "name": "acme-registry",
  "format_version": 1,
  "categories": [{ "name": "web", "index": "categories/web.json" }]
}

// categories/web.json
{
  "category": "web",
  "packages": [{
    "name": "example-web",
    "type": "app",
    "description": "Example web application",
    "source": { "git": "https://github.com/acme/example-web" }
  }]
}

GitHub-репозиторий

Закоммитьте файлы в публичный репозиторий и добавьте URL raw-каталога:

asc source add https://raw.githubusercontent.com/acme/my-registry/main --name acme
asc update
asc search example-web
asc install example-web --source acme

Свой сайт

Отдавайте каталог JSON по HTTPS. Пример для Nginx:

server {
  listen 443 ssl;
  server_name packages.example.com;
  root /var/www/asc-registry;
  location / { try_files $uri =404; }
}

sudo asc source add https://packages.example.com --name acme
asc update
asc search example-web

Проверяйте JSON по схемам registry. sudo asc source add делает источник общим для всех пользователей сервера; без sudo он доступен только текущему пользователю.

Источники под управлением платформы

SourceService — API-эквивалент sudo asc source add/remove: то, как платформа AdminService.Cloud выкладывает реестры организации на подключённую ноду без доступа по SSH. ListSources отдаёт только системный список; ReplaceSources — его идемпотентная полная замена (включая удаления), поэтому на ноде под управлением платформы источник, добавленный вручную через sudo asc source add, будет удалён следующим пушем, если его нет в списке платформы. Анонсируется через capabilities в GetStatus как "sources".