Создание Markdown Viewer Worker на Cloudflare

Требования

• Аккаунт Cloudflare
• Аккаунт GitHub

1. Форк репозитория

1. Откройте boykopovar/md.
2. Нажмите Fork.

2. Создание KV Namespace

1. Workers & Pages → KV → Create Namespace.
2. Имя: MD_STORAGE. Add.

Лимиты бесплатного тарифа: 100 000 чтений, 1000 записей, 1000 удалений в день, до 1 ГБ хранилища (на момент написания документа).

3. Настройка количества файлов (опционально)

В index.js:

const MAX_FILES = 200;

Изменить на нужное значение:

const MAX_FILES = 500;

4. Создание Worker

1. Cloudflare Dashboard → Workers & Pages → Create Worker.
2. Имя: md. Create.

Код и KV на этом этапе ещё не подключены.

5. Деплой через GitHub

1. Workers & Pages → ваш Worker (md) → Deploy → GitHub.
2. Подключите аккаунт GitHub.
3. Выберите репозиторий <username>/md.
4. Cloudflare подтянет код из ветки main.

После каждого git push Worker передеплоивается автоматически.

6. Привязка KV Namespace

1. Worker (md) → Settings → Variables → KV Namespace Bindings → Add binding.
2. Variable name: KV.
3. KV Namespace: MD_STORAGE.
4. Save.

Имя переменной должно совпадать с env.KV в коде.

При каждом новом деплое привязка сбрасывается и требует повторной настройки. Альтернатива - прописать в wrangler.toml:

[[kv_namespaces]]
binding = "KV"
id = "<ID KV Namespace>"

ID KV Namespace - чувствительные данные. Использовать только в приватном репозитории.

7. Проверка

curl -X POST -d "# Hello\nThis is a test" https://view-md<домен>.workers.dev

Ответ содержит ссылку вида https://view-md<домен>.workers.dev/view/<id>. Откройте её в браузере.

Возможные проблемы

• KV Namespace не привязан.
• Имя Worker в коде не совпадает с настройками.