aws-cdk 2.1122.0 → 2.1124.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -0
- package/THIRD_PARTY_LICENSES +3604 -238
- package/build-info.json +2 -2
- package/lib/cli/cli-config.js +2 -1
- package/lib/cli/cli-type-registry.json +5 -0
- package/lib/cli/cli.js +8 -2
- package/lib/cli/convert-to-user-input.js +3 -1
- package/lib/cli/parse-command-line-arguments.js +7 -1
- package/lib/cli/user-configuration.js +2 -1
- package/lib/cli/user-input.d.ts +6 -0
- package/lib/cli/user-input.js +1 -1
- package/lib/cli/util/check-unknown-options.d.ts +9 -0
- package/lib/cli/util/check-unknown-options.js +83 -0
- package/lib/index.js +189308 -126535
- package/lib/index_bg.wasm +0 -0
- package/lib/init-templates/.init-version.json +1 -1
- package/package.json +11 -11
package/README.md
CHANGED
|
@@ -1803,6 +1803,8 @@ Some of the interesting keys that can be used in the JSON configuration files:
|
|
|
1803
1803
|
"context": { // Context entries (--context=key=value)
|
|
1804
1804
|
"key": "value"
|
|
1805
1805
|
},
|
|
1806
|
+
"profile": "my-profile", // Use AWS profile as default (--profile=my-profile)
|
|
1807
|
+
"region": "us-west-2", // Use AWS region as default (--region=us-west-2)
|
|
1806
1808
|
"toolkitStackName": "foo", // Customize 'bootstrap' stack name (--toolkit-stack-name=foo)
|
|
1807
1809
|
"toolkitBucket": {
|
|
1808
1810
|
"bucketName": "amzn-s3-demo-bucket", // Customize 'bootstrap' bucket name (--toolkit-bucket-name=amzn-s3-demo-bucket)
|
|
@@ -1825,6 +1827,20 @@ The following environment variables affect aws-cdk:
|
|
|
1825
1827
|
- `CDK_DISABLE_VERSION_CHECK`: If set, disable automatic check for newer versions.
|
|
1826
1828
|
- `CDK_NEW_BOOTSTRAP`: use the modern bootstrapping stack.
|
|
1827
1829
|
|
|
1830
|
+
### Region resolution
|
|
1831
|
+
|
|
1832
|
+
The CDK CLI determines which AWS region to use with the following priority order (highest first):
|
|
1833
|
+
|
|
1834
|
+
1. `--region` flag (or `region` in `cdk.json`)
|
|
1835
|
+
2. `AWS_REGION` / `AMAZON_REGION` environment variable
|
|
1836
|
+
3. `AWS_DEFAULT_REGION` / `AMAZON_DEFAULT_REGION` environment variable
|
|
1837
|
+
4. Region from the shared INI files (`~/.aws/credentials` then `~/.aws/config`) for the active profile
|
|
1838
|
+
5. Region from the `[default]` profile in the shared INI files
|
|
1839
|
+
6. EC2 instance metadata (IMDS)
|
|
1840
|
+
7. `us-east-1`
|
|
1841
|
+
|
|
1842
|
+
When `--profile` is specified, the region configured in that profile is used (step 4). When `--region` is also specified, it takes priority over everything else including environment variables and the profile's own region setting. This is consistent with how the AWS CLI handles `--region`, and is useful for non-commercial partitions where the default `us-east-1` fallback would fail because credentials are partition-specific.
|
|
1843
|
+
|
|
1828
1844
|
### Running in CI
|
|
1829
1845
|
|
|
1830
1846
|
The CLI will attempt to detect whether it is being run in CI by looking for the presence of an
|