Свой KaaS: понятный продукт и надёжные операции

Практика через терминал портала

1. Создай отдельную модель продукта

   Используй новый каталог, чтобы не смешать состояние с уроком контроллеров. Код работает только локально и не подключается к облаку.

   umask 077
   mkdir -p ~/kaas-learning/product
   cd ~/kaas-learning/product
   curl -fSLo kaas_model.py https://test.igorhome.ru/static/learning/kaas_model.py
   python3 kaas_model.py selftest
   python3 kaas_model.py init

   Что должно получиться. Создан закрытый файл model.sqlite.tokens.json с двумя учебными токенами. Команда не печатает значения.

   Если результат отличается

   Повторный init намеренно не перезаписывает файл. Не публикуй его в Git и не вставляй в заметки.

2. Запусти интерфейс

   В портале доступен один активный терминал. Запусти только свой учебный сервер в фоне и сохрани PID (Process Identifier — идентификатор процесса) в переменной. Остальные команды выполняются в том же терминале. Сервер слушает только 127.0.0.1; внешний прокси не нужен.

   cd ~/kaas-learning/product
   python3 kaas_model.py serve </dev/null >model-server.log 2>&1 &
   KAAS_MODEL_PID=$!
   printf '%s\n' "$KAAS_MODEL_PID" > model-server.pid
   sleep 1
   cat model-server.log

   Что должно получиться. Справочная строка указывает http://127.0.0.1:18080. Это локальный учебный API (Application Programming Interface — программный интерфейс), не публичная услуга.

   Если результат отличается

   Если порт занят, проверь свой предыдущий процесс. Останавливай только собственный учебный сервер, не неизвестный процесс. При закрытии терминала фоновый процесс может остановиться; база сохраняется.

3. Прими намерение

   В том же терминале прочитай токены в переменные, не выводя их. Сделай запрос alice и сохрани ответ с идентификаторами операции и кластера.

   cd ~/kaas-learning/product
   ALICE_TOKEN=$(python3 -c 'import json; print(json.load(open("model.sqlite.tokens.json"))["alice"])')
   BOB_TOKEN=$(python3 -c 'import json; print(json.load(open("model.sqlite.tokens.json"))["bob"])')
   curl -sS -D create.headers -o create.json -H "Authorization: Bearer $ALICE_TOKEN" -H 'Content-Type: application/json' -H 'Idempotency-Key: product-1' --data '{"plan":"small"}' http://127.0.0.1:18080/v1/clusters
   cat create.headers create.json
   OPERATION_ID=$(python3 -c 'import json; print(json.load(open("create.json"))["id"])')
   CLUSTER_ID=$(python3 -c 'import json; print(json.load(open("create.json"))["cluster_id"])')

   Что должно получиться. Ответ 202 и Location операции; состояние Pending. Машина в реальном облаке не появилась.

   Если результат отличается

   Ответ 401 означает проблему токена; не убирай авторизацию из сервера ради продолжения.

4. Повтори и проверь конфликт

   Сначала повтори предыдущий запрос без изменений. Затем поменяй plan, оставив ключ. Это намеренно отрицательный тест.

   curl -i -H "Authorization: Bearer $ALICE_TOKEN" -H 'Idempotency-Key: product-1' --data '{"plan":"small"}' http://127.0.0.1:18080/v1/clusters
   curl -i -H "Authorization: Bearer $ALICE_TOKEN" -H 'Idempotency-Key: product-1' --data '{"plan":"large"}' http://127.0.0.1:18080/v1/clusters

   Что должно получиться. Одинаковые параметры вернули ту же операцию; изменённые — 409. Новой записи кластера нет.

   Если результат отличается

   Новый ключ означал бы другое намерение. Не меняй его в опыте повторения.

5. Переживи прерывание обработчика

   Запусти worker с учебным отказом, затем снова без него. Проверка list показывает состояние, операцию и отдельный список поддельных внешних ресурсов.

   python3 kaas_model.py reconcile --crash
   python3 kaas_model.py list alice
   python3 kaas_model.py reconcile
   python3 kaas_model.py list alice

   Что должно получиться. После прерывания операция Pending и один внешний ресурс; после повтора Ready и всё ещё один ресурс.

   Если результат отличается

   Если Pending нет, используй новый цикл после корректного удаления. Не считай обычный повтор завершённого задания опытом прерывания.

6. Проверь чужой доступ и квоту

   Переменные идентификаторов уже взяты из ответа create.json. Проверь, что чтение и удаление от bob запрещены, затем проверь дополнительное создание alice при занятой квоте.

   curl -i -H "Authorization: Bearer $BOB_TOKEN" "http://127.0.0.1:18080/v1/operations/$OPERATION_ID"
   curl -i -X DELETE -H "Authorization: Bearer $BOB_TOKEN" "http://127.0.0.1:18080/v1/clusters/$CLUSTER_ID"
   curl -i -H "Authorization: Bearer $ALICE_TOKEN" -H 'Idempotency-Key: product-2' --data '{"plan":"small"}' http://127.0.0.1:18080/v1/clusters
   python3 kaas_model.py selftest

   Что должно получиться. Чужие обращения дают 404, квота — 409. Самопроверка отдельно воспроизводит гонку двух запросов.

   Если результат отличается

   Проверка скрытых кнопок браузера не заменяет запросы к серверу. Проверяй каждый метод.

7. Пройди удаление и повтор

   Используй сохранённый CLUSTER_ID. Запрос ставит удаление в очередь; обработчик подтверждает очистку. Затем сравни инвентарь.

   curl -i -X DELETE -H "Authorization: Bearer $ALICE_TOKEN" "http://127.0.0.1:18080/v1/clusters/$CLUSTER_ID"
   python3 kaas_model.py reconcile
   python3 kaas_model.py list alice

   Что должно получиться. Deleted, внешних ресурсов нет; операция удаления остаётся в истории. Повтор DELETE возвращает ту же операцию.

   Если результат отличается

   Нельзя освобождать квоту до подтверждения очистки. Исчезнувшая строка интерфейса не является доказательством.

8. Спроектируй настоящий продукт

   Останови свой учебный сервер по сохранённому PID (Process Identifier — идентификатор процесса), убери переменные токенов. Заполни capstone-openapi.yaml и расчёт стоимости: один план, создание, статус, удаление, поддержка. Для настоящего провайдера используй результаты предыдущего модуля.

   kill "$KAAS_MODEL_PID"
   wait "$KAAS_MODEL_PID" 2>/dev/null || true
   unset ALICE_TOKEN BOB_TOKEN KAAS_MODEL_PID
   python3 kaas_model.py selftest

   Что должно получиться. Есть локально проверенная модель и отдельный список обязательных работ до OpenStack-пилота. Токены не попали в заметки.

   Если результат отличается

   Не отмечай облачный lifecycle по локальному selftest. Производственный интерфейс требует отдельного развёртывания и проверки.

Открыть терминал ↗ · Скачать файлы лаборатории →

Файлы и подготовка к этой работе

• Подготовка отдельного стенда и правила работы ↗
• Python-модель операций и учебного API (Application Programming Interface — программный интерфейс) ↗

Критерии готовности

Отмечай только то, что проверил на указанном стенде. Эти галочки сохраняются в браузере. Для готовых упражнений зачёт выдаёт отдельная серверная проверка практикума; остальные задания подтверждай журналом и доказательствами. Учебная модель не заменяет реальный облачный опыт.

Что сохранить в портфолио

• Журнал: исходное состояние → команда или действие → ожидаемый результат → фактическое наблюдение.
• Доказательства по критериям ниже: очищенный от секретов вывод, схема или ссылка на проверенный коммит.
• Отдельный список: что пока не запускалось, почему и какой стенд нужен для продолжения.

Проверь понимание

8 вопросов по этому модулю. Проходной результат — 7 из 8. После ответа — объяснения и ссылки на разделы, к которым стоит вернуться.