Проверка дескрипторов Labs

Прочитайте каталог Labs и проверьте локальный дескриптор состояния границ.

Altifigence CLI 0.1.9 в Linux предоставляет локальный рабочий процесс с дескрипторами Labs. Используйте его для просмотра фиксированного каталога рабочих процессов, чтения состояния дескрипторов и проверки JSON-сводки состояния границ. Команды возвращают метаданные, которые можно сохранить вместе с материалами проверки. Начните с каталога и состояния, чтобы установить, какие дескрипторы вы проверяете.

Перед чтением сохранённого результата убедитесь, что код завершения равен 0. Сохраняйте стандартный поток ошибок отдельно и проверяйте поля результата, описанные ниже.

Чтение каталога

alti labs inspect
alti labs status

Для небольшого примера проверки сохраните приведённый ниже JSON как boundary-health.json внутри существующего проекта. Этот пример содержит пустые массивы карточек состояния и ссылок на источники; он демонстрирует структуру дескриптора, принимаемую валидатором. Если требуется содержательная проверка состояния, заполните рабочую сводку на основе проверенного перечня. Поля идентификации, охвата и безопасности входят в проверяемую структуру.

Сохранение дескриптора

{
  "schemaVersion": "altifigence.lab.json-boundary-health-summary.v0",
  "tool": "alti-lab",
  "healthSummaryId": "local-example",
  "summaryState": "descriptor_only",
  "inventoryState": "checked_fixture",
  "sourceInventoryRef": {},
  "coverageSummary": {
    "overallState": "checked",
    "summaryOnly": true,
    "descriptorOnly": true
  },
  "consumerPolicy": {},
  "safetyFlags": {
    "dataOnly": true,
    "descriptorOnly": true,
    "readOnly": true,
    "summaryOnly": true,
    "commandExecution": false,
    "shellExecution": false,
    "runtimeExecution": false,
    "networkCalls": false,
    "repositoryMutation": false
  },
  "sourceCheckRefs": [],
  "healthCards": [],
  "driftGates": [],
  "blockedActions": [],
  "limitations": [],
  "issueRefs": []
}

Проверка сохранённого файла

alti labs validate --project /absolute/project boundary-health.json

Используйте абсолютный путь проекта и путь дескриптора относительно этого проекта. При успешном выполнении команда выводит проверенный дескриптор в формате JSON. Сравните идентификационные данные возвращённой сводки с сохранёнными входными данными, затем сохраните файл и вывод вместе. Валидация проверяет заявленную структуру дескриптора.

Изучение вывода проверки

Ниже показаны отдельные поля вывода успешной проверки. Полный вывод сохраняет остальные поля дескриптора.

{"schemaVersion":"altifigence.lab.json-boundary-health-summary.v0","tool":"alti-lab","healthSummaryId":"local-example","summaryState":"descriptor_only","inventoryState":"checked_fixture"}

При ошибке unsupported JSON boundary health summary schema задайте schemaVersion равным altifigence.lab.json-boundary-health-summary.v0, как показано во входных данных, затем повторите проверку.