共享文件 config 和 credentials 的位置 - AWS SDKs和工具

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

共享文件 configcredentials 的位置

共享credentials文件 AWS config和文件是纯文本文件,其中包含软件开发工具包和 AWS 工具的配置信息。这些文件位于您的本地环境中,由 SDK 代码或在该环境中运行的 AWS CLI 命令自动使用。例如,在您自己的计算机上或在 Amazon 弹性计算云实例上进行开发时。

当 SDK 或工具运行时,它会检查这些文件并加载所有可用的配置设置。如果这些文件尚不存在,则 SDK 或工具会自动创建基本文件。

默认情况下,这些文件位于名为的文件夹中.aws,该文件夹位于您的home或用户文件夹中。

操作系统 文件的默认位置和名称
Linux 和 macOS

~/.aws/config

~/.aws/credentials

Windows

%USERPROFILE%\.aws\config

%USERPROFILE%\.aws\credentials

主目录解析

~仅在以下情况下才用于主目录解析:

  • 开始路径

  • 紧随其后的是/或平台特定的分隔符。在 Windows 上~/~\两者都解析到主目录。

在确定主目录时,会检查以下变量:

  • (所有平台)HOME 环境变量

  • (Windows 平台)USERPROFILE 环境变量

  • (Windows 平台)HOMEDRIVEHOMEPATH环境变量的串联 () $HOMEDRIVE$HOMEPATH

  • (可选,根据 SDK 或工具)特定于 SDK 或工具的主路径解析函数或变量

如有可能,如果在路径开头指定了用户的主目录(例如,~username/),则会将其解析到请求的用户名的起始目录(例如,/home/username/.aws/config)。

更改这些文件的默认位置

您可以使用以下任一方法来覆盖 SDK 或工具加载这些文件的位置。

使用环境变量

可以设置以下环境变量,将这些文件的位置或名称从默认值更改为自定义值:

  • config 文件环境变量:AWS_CONFIG_FILE

  • credentials 文件环境变量:AWS_SHARED_CREDENTIALS_FILE

Linux/macOS

您可以通过在 Linux 或 macOS 上运行以下导出命令来指定备用位置。

$ export AWS_CONFIG_FILE=/some/file/path/on/the/system/config-file-name $ export AWS_SHARED_CREDENTIALS_FILE=/some/other/file/path/on/the/system/credentials-file-name
Windows

您可以通过在 Windows 上运行以下setx命令来指定备用位置。

C:\> setx AWS_CONFIG_FILE c:\some\file\path\on\the\system\config-file-name C:\> setx AWS_SHARED_CREDENTIALS_FILE c:\some\other\file\path\on\the\system\credentials-file-name

有关使用环境变量配置系统的更多信息,请参阅环境变量支持

使用 JVM 系统属性

对于在 JVM 上运行的 Kotlin 开发工具包和适用于 Java 2.x 的 SDK,您可以设置以下 JVM 系统属性,将这些文件的位置或名称从默认值更改为自定义值:

  • config文件 JVM 系统属性:aws.configFile

  • credentials 文件环境变量:aws.sharedCredentialsFile

有关如何设置 JVM 系统属性的说明,请参阅如何设置 JVM 系统属性。适用于 Java 的 SDK 1.x 不支持这些系统属性。