diff --git a/docs/classes/AWS.html b/docs/classes/AWS.html index 4a93c13..7dcc22d 100644 --- a/docs/classes/AWS.html +++ b/docs/classes/AWS.html @@ -151,7 +151,7 @@

Usage:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/ChainableTemporaryCredentials.html b/docs/classes/ChainableTemporaryCredentials.html index 2b5590a..01cdf42 100644 --- a/docs/classes/ChainableTemporaryCredentials.html +++ b/docs/classes/ChainableTemporaryCredentials.html @@ -147,7 +147,7 @@

Usage:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/CredentialProviderChain.html b/docs/classes/CredentialProviderChain.html index 1fa2568..513e315 100644 --- a/docs/classes/CredentialProviderChain.html +++ b/docs/classes/CredentialProviderChain.html @@ -131,7 +131,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/Credentials.html b/docs/classes/Credentials.html index 8d5d06c..2a9ed58 100644 --- a/docs/classes/Credentials.html +++ b/docs/classes/Credentials.html @@ -266,7 +266,7 @@

Returns:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/EC2MetadataCredentials.html b/docs/classes/EC2MetadataCredentials.html index 2a51bf0..0864b18 100644 --- a/docs/classes/EC2MetadataCredentials.html +++ b/docs/classes/EC2MetadataCredentials.html @@ -113,7 +113,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/EnvironmentCredentials.html b/docs/classes/EnvironmentCredentials.html index 833030f..0638510 100644 --- a/docs/classes/EnvironmentCredentials.html +++ b/docs/classes/EnvironmentCredentials.html @@ -122,7 +122,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/RemoteCredentials.html b/docs/classes/RemoteCredentials.html index 7b48fa6..e776d0c 100644 --- a/docs/classes/RemoteCredentials.html +++ b/docs/classes/RemoteCredentials.html @@ -113,7 +113,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/SharedFileCredentials.html b/docs/classes/SharedFileCredentials.html index ff07d1f..d7011a7 100644 --- a/docs/classes/SharedFileCredentials.html +++ b/docs/classes/SharedFileCredentials.html @@ -113,7 +113,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/classes/TokenFileWebIdentityCredentials.html b/docs/classes/TokenFileWebIdentityCredentials.html index e00c954..601c80a 100644 --- a/docs/classes/TokenFileWebIdentityCredentials.html +++ b/docs/classes/TokenFileWebIdentityCredentials.html @@ -128,7 +128,7 @@

Parameters:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/index.html b/docs/index.html index 6ba7ecb..03b9e4d 100644 --- a/docs/index.html +++ b/docs/index.html @@ -126,7 +126,7 @@

Topics

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/modules/resty.aws.config.html b/docs/modules/resty.aws.config.html index 9d14e1e..a9e7dab 100644 --- a/docs/modules/resty.aws.config.html +++ b/docs/modules/resty.aws.config.html @@ -354,7 +354,7 @@

Returns:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/modules/resty.aws.service.rds.signer.html b/docs/modules/resty.aws.service.rds.signer.html index 618a233..039213f 100644 --- a/docs/modules/resty.aws.service.rds.signer.html +++ b/docs/modules/resty.aws.service.rds.signer.html @@ -191,7 +191,7 @@

Usage:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/modules/resty.aws.utils.html b/docs/modules/resty.aws.utils.html index fc05e49..96ad935 100644 --- a/docs/modules/resty.aws.utils.html +++ b/docs/modules/resty.aws.utils.html @@ -196,7 +196,7 @@

Returns:

generated by LDoc 1.5.0 -Last updated 2023-09-13 03:26:04 +Last updated 2023-09-13 09:23:08
diff --git a/docs/topics/README.md.html b/docs/topics/README.md.html index 41cb6b7..21c581a 100644 --- a/docs/topics/README.md.html +++ b/docs/topics/README.md.html @@ -130,17 +130,22 @@

TLS and certificate failures

Global settings

This library depends on global settings. Especially the core services for authentication -and metadata. Many of those can (also) be specified as environment variables.

+and metadata. Many of those can (also) be specified as environment variables. Environment +variables can only be accessed during the OpenResty init phase. Thus, to ensure correct +configuration from environment variables, the resty.aws.config module must be required on +the top-level of the module using this library:

-

Hence it is recommended to populate the global configuration object at application start -in the OpenResty init phase. Simply add the following line;

-
         local _ = require("resty.aws.config").global
-
+
+local aws_config = require("resty.aws.config")
+
-

This ensures the environment variables can still be read (in the init phase). And -the auto-detection of the AWS region will execute.

+

The .global property of the aws_config variable can then be used as the global +configuration. Note that when .global is first accessed, automatic region detection +through the AWS metadata service is performed. Thus, it is not advisable to access +it on the module level unless to avoid startup delays in non-AWS environment, caused by +the requests to the metadata service timing out.

@@ -274,6 +279,13 @@

History

  • test installing the rock from LuaRocks
    • +

    1.3.3 (13-Sep-2023)

    + + +

    1.3.2 (13-Sep-2023)