aws_endpoint
Директива `aws_endpoint` указывает конечную точку AWS для сервиса S3 при использовании модуля аутентификации AWS для NGINX.
Описание
Директива aws_endpoint используется в конфигурации NGINX для определения конкретной конечной точки AWS, необходимой для взаимодействия с аутентифицированными сервисами, особенно с Amazon S3. Когда она задана, эта директива позволяет NGINX направлять запросы на правильную региональную конечную точку, улучшая соединение и уменьшая задержку за счёт направления запросов к ближайшему географическому расположению сервиса. Конечная точка AWS является критически важным компонентом, поскольку разные регионы AWS используют разные конечные точки, которые определяют URL, используемый для вызовов сервиса.
Директива принимает один аргумент — допустимую строку, представляющую требуемую конечную точку AWS, например s3.us-west-1.amazonaws.com или s3.cn-north-1.amazonaws.com.cn. Её необходимо определять в контексте блоков http, server или location, и обычно она используется вместе с другими директивами конфигурации AWS, такими как aws_access_key, aws_signing_key и aws_s3_bucket, чтобы обеспечить корректную аутентификацию и авторизацию запросов. Эта директива особенно полезна в конфигурациях, где несколько бакетов S3 из разных регионов обслуживаются одним экземпляром NGINX, что позволяет детально управлять маршрутизацией запросов в зависимости от их географических характеристик.
Важно отметить, что если эта директива не указана, будет использоваться конечная точка по умолчанию s3.amazonaws.com, что может привести к проблемам, если ресурсы размещены в других регионах. Она помогает адаптировать поведение модуля в соответствии с инфраструктурными потребностями размещаемого приложения.
Пример конфига
server {
listen 8000;
aws_access_key your_aws_access_key;
aws_key_scope scope_of_generated_signing_key;
aws_signing_key signing_key_generated_using_script;
aws_s3_bucket your_s3_bucket;
location /s3_beijing {
aws_endpoint "s3.cn-north-1.amazonaws.com.cn";
proxy_pass http://your_s3_bucket.s3.cn-north-1.amazonaws.com.cn;
}
}Убедитесь, что конечная точка соответствует целевому региону AWS, чтобы избежать проблем с подключением.
Не забывайте регулярно обновлять ключ подписи; он действителен всего одну неделю.
Конечная точка должна быть заключена в кавычки; в противном случае это может привести к синтаксическим ошибкам.