LocalStack 如何配置 AWS 沙箱账户让集成测试针对真实云运行【免费下载链接】localstack A fully functional local AWS cloud stack. Develop and test your cloud Serverless apps offline项目地址: https://gitcode.com/GitHub_Trending/lo/localstack在 LocalStack 仓库中开发或维护测试时集成测试默认跑在本地 LocalStack 实例上。当你想验证测试能否在真实 AWS 上通过时需要把测试目标切换到 AWS Cloud。官方测试文档建议为此专门使用一个 AWS 沙箱账户sandbox account避免测试误打到生产账户上——测试创建的资源队列、桶、函数等会真实产生计费。本文依据 integration-tests 文档 给出完整路径创建沙箱账户、配置 CLI profile、设置环境变量把测试指向真实 AWS。前置条件一个可以管理 IAM 的 AWS 账户、已安装 AWS CLI、可运行 LocalStack 仓库的 pytest 测试套件。在 IAM 中创建沙箱账户以下步骤来自文档 Creating an AWS sandbox account 小节在 AWS 管理控制台中完成使用具有AWSAdministratorAccess的凭证登录你的 AWS 沙箱账户。在顶部搜索栏输入IAM进入 IAM 服务。进入Users点击Add Users创建新用户用户名填localstack-testing不要勾选 Provide user access to the AWS Management Console 选项——该用户只用 API 访问。选择 Attach existing policies directly。勾选AdministratorAccess然后连续点击 Next 直到创建完成。在IAM/Users中找到刚创建的用户进入Security Credentials标签页在Access Keys区域点击Create access key。选择Local code选项并勾选 I understand the above recommendation and want to proceed to create an access key。点击Create access key立即复制 Access Key ID 和 Secret access keySecret 只显示这一次。配置 CLI profile 并验证凭证拿到 Access Key 后为沙箱账户创建一个独立的 CLI profile文档示例使用ls-sandboxaws configure --profile ls-sandbox按提示依次输入 Access Key ID 和 Secret access key。然后运行下面的命令确认 profile 配置正确能正常解析出身份aws sts get-caller-identity --profile ls-sandbox文档同时给出了配置完成后的文件形态可用来对照检查。~/.aws/credentials中your-key-id与your-secret-key替换为第 8 步复制到的真实值[ls-sandbox] aws_access_key_id your-key-id aws_secret_access_key your-secret-key~/.aws/config中为对应 profile 设置 region文档示例值为eu-central-1可按需修改也可追加其他 AWS client 配置项[ls-sandbox] regioneu-central-1 # .... you can add additional configuration options for AWS clients here设置环境变量让测试指向 AWS Cloud核心开关是环境变量TEST_TARGETAWS_CLOUD设置后测试框架中的 boto client 会自动配置为指向 AWS 而不是 LocalStack。同时把AWS_PROFILE指向上面创建的 profile 名。文档给出的环境配置示例如下示例中DEBUG1用于开启 debug 日志TEST_DISABLE_RETRIES_AND_TIMEOUTS1为文档给出的辅助开关export DEBUG1 export TEST_DISABLE_RETRIES_AND_TIMEOUTS1 export TEST_TARGETAWS_CLOUD export AWS_DEFAULT_REGIONus-east-1 export AWS_PROFILEls-sandbox设置后按常规方式运行测试套件例如TEST_PATHtests/integration make test或在虚拟环境中直接python -m pytest --log-cli-levelINFO tests/integration也可以把路径缩小到单个文件甚至单个测试类例如TEST_PATHtests/integration/docker_utils/test_docker.py::TestDockerClient make test。针对真实 AWS 运行时文档强调的约束用 client fixtures如aws_client或其他资源工厂 fixture 来创建资源而不是从aws_stack.py的方法这些 fixture 在TEST_TARGETAWS_CLOUD下自动改用 AWS profile 凭证。无论测试成功还是失败都要确保创建的 AWS 资源被清理fixture 的 try/finally 机制、工厂 fixture 等。针对 AWS 测试可能还需要额外的 role 和 policy遇到权限类报错时检查沙箱账户的授权。可选分支记录快照与强制启动本地实例快照测试可选。如果测试在 AWS 上稳定通过后可以记录快照用于 parity testing加参数--snapshot-update或环境变量SNAPSHOT_UPDATE1并设置TEST_TARGETAWS_CLOUD运行响应会被写入testfile-name.snapshot.json。后续不带该参数、不设置AWS_CLOUD目标时测试会拿 LocalStack 的响应与快照对比。详细写法见 Parity Testing 文档。强制同时启动本地实例可选。TEST_TARGETAWS_CLOUD下默认不会启动 LocalStack 实例。若某个测试需要同时访问本地实例可再设置TEST_FORCE_LOCALSTACK_START1。注意此时aws_clientfixture 仍指向 AWS需要自己用aws_client_factory构造指向本地实例的 client文档示例local_client aws_client_factory( endpoint_urlfhttp://{localstack_host()}, aws_access_key_idtest, aws_secret_access_keytest, )收尾标记已验证的测试当测试在 AWS 上稳定通过后按文档要求为它添加 pytest 标记markers.aws.validated表明该集成已经过真实 AWS 验证。这个标记也是tests/aws/**/test_*.py中每个测试必须恰好带有一个 marker 的规则的一部分marker 定义见 marking.py。限制与边界沙箱账户上的测试会真实创建并计费 AWS 资源务必确认测试的清理逻辑文档只保证AdministratorAccess这一授权路径具体服务若需要额外 role/policy需按报错自行补充。【免费下载链接】localstack A fully functional local AWS cloud stack. Develop and test your cloud Serverless apps offline项目地址: https://gitcode.com/GitHub_Trending/lo/localstack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考