← Data Localization Suite / data-localization / how-to

R2 Object Storage

В следующих разделах описано, как настроить R2 Object Storage вместе с Regional Services и Customer Metadata Boundary, чтобы контролировать, где обрабатываются запросы к объектам и где хранятся логи.

Regional Services

Чтобы настроить Regional Services для хостов проксируется (то есть трафик направляется через Cloudflare) через Cloudflare и обеспечить, чтобы обработка запросов к Бакет R2 происходит только внутри региона, выполните следующие действия:

На панели управления Cloudflare перейдите к разделу R2 страницу.
Перейдите в Обзор ↗
Выполните шаги, чтобы создать Bucket.
Подключение бакета к пользовательскому домену.
Выполните API POST команду для настроенного пользовательского домена бакета, чтобы создать regional_hostnames с определённым регионом.

Regional Services применяется только к пользовательскому домену, настроенному для R2 Bucket.

Отправка журналов в R2 через S3-совместимую конечную точку

Следующие инструкции показывают, как настроить задание Logpush с использованием S3-совместимой конечной точки для хранения логов в бакете R2 в выбранной вами юрисдикции.

Создайте Бакет R2 в вашем аккаунте Cloudflare и выберите юрисдикция который вы хотите использовать.
Создайте API-токен для вашего бакета R2. Доступны следующие два варианта:

Создайте токен для конкретного бакета (рекомендуется)

Перейдите в раздел R2 панели управления Cloudflare и выберите Управление API-токенами R2 чтобы создать токен, привязанный непосредственно к вашему бакету. Вы можете следовать инструкциям в Аутентификация раздел.

Создайте токен для всех бакетов

Вы можете создать API-токен в Manage Account > Токены API аккаунта либо вы можете создать токен для конкретного пользователя:

Перейдите в My Profile > API-токены
Выберите Create Token > Create Custom Token
Выберите Аккаунт > Workers R2 Storage > Изменить чтобы настроить разрешения.
Чтобы проверить токен, скопируйте curl команду и вставьте её в терминал.

curl "https://api.cloudflare.com/client/v4/user/tokens/verify" \
--header "Authorization: Bearer <API_TOKEN>"

Результат:

{
	"result": {
		"id": "325xxxxcd",
		"status": "active"
	},
	"success": true,
	"errors": [],
	"messages": [
		{
			"code": 10000,
			"message": "This API Token is valid and active",
			"type": null
		}
	]
}

Сгенерируйте SHA-256-хеш токена:

echo -n "<token>" | shasum -a 256

Эта команда выведет хеш, похожий на dxxxx391b.

Настройте место назначения Logpush с помощью S3-совместимая конечная точка и заполните следующие поля:

Бакет: введите имя бакета R2, созданного с нужной вам юрисдикцией.
Путь (необязательно): при необходимости можно указать путь к папке, чтобы упорядочить логи.
Endpoint URL: укажите конечную точку S3 API для вашего бакета в формате <account-id>.eu.r2.cloudflarestorage.com. Не включайте имя бакета, так как оно уже указано в первом поле.
Регион бакета: например, используйте WEUR чтобы указать регион EU.
Access Key ID: введите Token ID, созданный ранее (325xxxxcd).
Secret Access Key: используйте хеш SHA-256 токена (dxxxx391b).

Завершите настройку, выбрав поля, которые нужно передавать в бакет R2.

Customer Metadata Boundary

Если для Customer Metadata Boundary задано значение EU, R2 > Бакет > Метрики вкладка на панели управления аккаунта будет заполнена.

См. Документация R2, где это описано подробнее.