INTEGRITY Документация

Начало из Worker

Workers Sites требует Wrangler : обязательно используйте последняя версия.

Если у вас уже есть проект Worker, для отдачи статических assets в Worker можно использовать Workers Sites.

Начало работы

  1. Создайте в корне проекта каталог для assets (например, ./public)

  2. Добавьте в файл Wrangler конфигурацию, указывающую на него.

    {
      "site": {
        "bucket": "./public" // Add the directory with your static assets!
      }
    }
    [site]
    bucket = "./public"
  3. Установите @cloudflare/kv-asset-handler пакет в своём проекте:

    npm i -D @cloudflare/kv-asset-handler
  4. Импортируйте getAssetFromKV() функцию в точку входа вашего Worker и используйте её, чтобы отвечать статическими ресурсами.

import { getAssetFromKV } from "@cloudflare/kv-asset-handler";
import manifestJSON from "__STATIC_CONTENT_MANIFEST";
const assetManifest = JSON.parse(manifestJSON);

export default {
	async fetch(request, env, ctx) {
		try {
			// Add logic to decide whether to serve an asset or run your original Worker code
			return await getAssetFromKV(
				{
					request,
					waitUntil: ctx.waitUntil.bind(ctx),
				},
				{
					ASSET_NAMESPACE: env.__STATIC_CONTENT,
					ASSET_MANIFEST: assetManifest,
				},
			);
		} catch (e) {
			let pathname = new URL(request.url).pathname;
			return new Response(`"${pathname}" not found`, {
				status: 404,
				statusText: "not found",
			});
		}
	},
};
import { getAssetFromKV } from "@cloudflare/kv-asset-handler";

addEventListener("fetch", (event) => {
	event.respondWith(handleEvent(event));
});

async function handleEvent(event) {
	try {
		// Add logic to decide whether to serve an asset or run your original Worker code
		return await getAssetFromKV(event);
	} catch (e) {
		let pathname = new URL(event.request.url).pathname;
		return new Response(`"${pathname}" not found`, {
			status: 404,
			statusText: "not found",
		});
	}
}

Подробнее о настраиваемых параметрах getAssetFromKV() см. документация kv-asset-handler.

  1. Запустите wrangler deploy или npx wrangler deploy как обычно делаете это для своего проекта Worker. Wrangler автоматически загрузит ресурсы, найденные в настроенном каталоге.

    npx wrangler deploy