@@ -825,9 +825,7 @@ def populate_edge_configuration(
825
825
os .environ .get ("SQS_CLOUDWATCH_METRICS_REPORT_INTERVAL" ) or 60
826
826
)
827
827
828
- # DEPRECATED: deprecated since 2.0.0 but added back upon customer request for the new Lambda provider
829
- # Keep a bit longer until we are sure that LOCALSTACK_HOST covers the special scenario but do not advertise publicly.
830
- # Endpoint host under which LocalStack APIs are accessible from Lambda Docker containers.
828
+ # PUBLIC: Endpoint host under which LocalStack APIs are accessible from Lambda Docker containers.
831
829
HOSTNAME_FROM_LAMBDA = os .environ .get ("HOSTNAME_FROM_LAMBDA" , "" ).strip ()
832
830
833
831
# PUBLIC: hot-reload (default v2), __local__ (default v1)
@@ -1046,12 +1044,13 @@ def use_custom_dns():
1046
1044
# if `DISABLE_BOTO_RETRIES=1` is set, all our created boto clients will have retries disabled
1047
1045
DISABLE_BOTO_RETRIES = is_env_true ("DISABLE_BOTO_RETRIES" )
1048
1046
1049
- # HINT: Please add deprecated environment variables to deprecations.py
1050
-
1051
1047
# List of environment variable names used for configuration that are passed from the host into the LocalStack container.
1052
- # Make sure to keep this in sync with the above!
1053
- # Do *not* include any internal developer configurations that apply to host-mode only in this list.
1054
- # Note: do *not* include DATA_DIR in this list, as it is treated separately
1048
+ # => Synchronize this list with the above and the configuration docs:
1049
+ # https://docs.localstack.cloud/references/configuration/
1050
+ # => Sort this list alphabetically
1051
+ # => Add deprecated environment variables to deprecations.py and add a comment in this list
1052
+ # => Move removed legacy variables to the section grouped by release (still relevant for deprecation warnings)
1053
+ # => Do *not* include any internal developer configurations that apply to host-mode only in this list.
1055
1054
CONFIG_ENV_VARS = [
1056
1055
"ALLOW_NONSTANDARD_REGIONS" ,
1057
1056
"BOTO_WAITER_DELAY" ,
@@ -1064,7 +1063,6 @@ def use_custom_dns():
1064
1063
"CUSTOM_SSL_CERT_PATH" ,
1065
1064
"DEBUG" ,
1066
1065
"DEBUG_HANDLER_CHAIN" ,
1067
- "DEFAULT_REGION" , # Not functional; deprecated in 0.12.7, removed in 3.0.0
1068
1066
"DEVELOP" ,
1069
1067
"DEVELOP_PORT" ,
1070
1068
"DISABLE_BOTO_RETRIES" ,
@@ -1090,24 +1088,17 @@ def use_custom_dns():
1090
1088
"DYNAMODB_READ_ERROR_PROBABILITY" ,
1091
1089
"DYNAMODB_WRITE_ERROR_PROBABILITY" ,
1092
1090
"EAGER_SERVICE_LOADING" ,
1093
- "EDGE_FORWARD_URL" , # Not functional; Deprecated in 1.4.0, removed in 3.0.0
1094
1091
"ENABLE_CONFIG_UPDATES" ,
1095
- "ES_CUSTOM_BACKEND" ,
1096
- "ES_ENDPOINT_STRATEGY" ,
1097
- "ES_MULTI_CLUSTER" ,
1098
1092
"EXTRA_CORS_ALLOWED_HEADERS" ,
1099
1093
"EXTRA_CORS_ALLOWED_ORIGINS" ,
1100
1094
"EXTRA_CORS_EXPOSE_HEADERS" ,
1101
1095
"GATEWAY_LISTEN" ,
1102
1096
"HOSTNAME" ,
1103
- "HOSTNAME_EXTERNAL" ,
1104
- "HOSTNAME_FROM_LAMBDA" , # deprecated since 2.0.0 but added to new Lambda provider
1097
+ "HOSTNAME_FROM_LAMBDA" ,
1105
1098
"KINESIS_ERROR_PROBABILITY" ,
1106
- "KINESIS_INITIALIZE_STREAMS" , # Not functional; Deprecated in 1.4.0, removed in 3.0.0
1107
1099
"KINESIS_MOCK_PERSIST_INTERVAL" ,
1108
1100
"KINESIS_MOCK_LOG_LEVEL" ,
1109
1101
"KINESIS_ON_DEMAND_STREAM_COUNT_LIMIT" ,
1110
- "KMS_PROVIDER" , # Not functional; Deprecated in 1.4.0, removed in 3.0.0
1111
1102
"LAMBDA_DOCKER_DNS" ,
1112
1103
"LAMBDA_DOCKER_FLAGS" ,
1113
1104
"LAMBDA_DOCKER_NETWORK" ,
@@ -1121,7 +1112,6 @@ def use_custom_dns():
1121
1112
"LAMBDA_INIT_RELEASE_VERSION" ,
1122
1113
"LAMBDA_KEEPALIVE_MS" ,
1123
1114
"LAMBDA_RUNTIME_IMAGE_MAPPING" ,
1124
- "LAMBDA_JAVA_OPTS" ,
1125
1115
"LAMBDA_REMOVE_CONTAINERS" ,
1126
1116
"LAMBDA_RUNTIME_EXECUTOR" ,
1127
1117
"LAMBDA_RUNTIME_ENVIRONMENT_TIMEOUT" ,
@@ -1135,14 +1125,11 @@ def use_custom_dns():
1135
1125
"LAMBDA_LIMITS_CODE_SIZE_UNZIPPED" ,
1136
1126
"LAMBDA_LIMITS_CREATE_FUNCTION_REQUEST_SIZE" ,
1137
1127
"LAMBDA_LIMITS_MAX_FUNCTION_ENVVAR_SIZE_BYTES" ,
1138
- "LEGACY_DIRECTORIES" ,
1139
1128
"LEGACY_DOCKER_CLIENT" ,
1140
- "LEGACY_EDGE_PROXY" , # Not functional; Deprecated in 1.0.0, removed in 3.0.0
1141
1129
"LEGACY_SNS_GCM_PUBLISHING" ,
1142
1130
"LOCALSTACK_API_KEY" ,
1143
1131
"LOCALSTACK_AUTH_TOKEN" ,
1144
1132
"LOCALSTACK_HOST" ,
1145
- "LOCALSTACK_HOSTNAME" ,
1146
1133
"LOG_LICENSE_ISSUES" ,
1147
1134
"LS_LOG" ,
1148
1135
"MAIN_CONTAINER_NAME" ,
@@ -1171,29 +1158,43 @@ def use_custom_dns():
1171
1158
"STRICT_SERVICE_LOADING" ,
1172
1159
"TEST_AWS_ACCOUNT_ID" ,
1173
1160
"TF_COMPAT_MODE" ,
1174
- "USE_SINGLE_REGION" , # Not functional; deprecated in 0.12.7, removed in 3.0.0
1175
1161
"USE_SSL" ,
1176
1162
"WAIT_FOR_DEBUGGER" ,
1177
1163
"WINDOWS_DOCKER_MOUNT_PREFIX" ,
1178
- # Removed in 3.0.0
1164
+ # Removed legacy variables in 2.0.0
1165
+ # DATA_DIR => do *not* include in this list, as it is treated separately. # deprecated since 1.0.0
1166
+ "LEGACY_DIRECTORIES" , # deprecated since 1.0.0
1167
+ "SYNCHRONOUS_API_GATEWAY_EVENTS" , # deprecated since 1.3.0
1168
+ "SYNCHRONOUS_DYNAMODB_EVENTS" , # deprecated since 1.3.0
1169
+ "SYNCHRONOUS_SNS_EVENTS" , # deprecated since 1.3.0
1170
+ "SYNCHRONOUS_SQS_EVENTS" , # deprecated since 1.3.0
1171
+ # Removed legacy variables in 3.0.0
1172
+ "DEFAULT_REGION" , # deprecated since 0.12.7
1179
1173
"EDGE_BIND_HOST" , # deprecated since 2.0.0
1174
+ "EDGE_FORWARD_URL" , # deprecated since 1.4.0
1180
1175
"EDGE_PORT" , # deprecated since 2.0.0
1181
1176
"EDGE_PORT_HTTP" , # deprecated since 2.0.0
1177
+ "ES_CUSTOM_BACKEND" , # deprecated since 0.14.0
1178
+ "ES_ENDPOINT_STRATEGY" , # deprecated since 0.14.0
1179
+ "ES_MULTI_CLUSTER" , # deprecated since 0.14.0
1180
+ "HOSTNAME_EXTERNAL" , # deprecated since 2.0.0
1181
+ "KINESIS_INITIALIZE_STREAMS" , # deprecated since 1.4.0
1182
+ "KINESIS_PROVIDER" , # deprecated since 1.3.0
1183
+ "KMS_PROVIDER" , # deprecated since 1.4.0
1182
1184
"LAMBDA_XRAY_INIT" , # deprecated since 2.0.0
1183
1185
"LAMBDA_CODE_EXTRACT_TIME" , # deprecated since 2.0.0
1184
1186
"LAMBDA_CONTAINER_REGISTRY" , # deprecated since 2.0.0
1185
1187
"LAMBDA_EXECUTOR" , # deprecated since 2.0.0
1186
1188
"LAMBDA_FALLBACK_URL" , # deprecated since 2.0.0
1187
1189
"LAMBDA_FORWARD_URL" , # deprecated since 2.0.0
1190
+ "LAMBDA_JAVA_OPTS" , # currently only supported in old Lambda provider but not officially deprecated
1188
1191
"LAMBDA_REMOTE_DOCKER" , # deprecated since 2.0.0
1189
1192
"LAMBDA_STAY_OPEN_MODE" , # deprecated since 2.0.0
1190
- "SQS_PORT_EXTERNAL" , # deprecated in docs since 2022-07-13
1193
+ "LEGACY_EDGE_PROXY" , # deprecated since 1.0.0
1194
+ "LOCALSTACK_HOSTNAME" , # deprecated since 2.0.0
1195
+ "SQS_PORT_EXTERNAL" , # deprecated only in docs since 2022-07-13
1191
1196
"SYNCHRONOUS_KINESIS_EVENTS" , # deprecated since 1.3.0
1192
- "SYNCHRONOUS_SNS_EVENTS" , # deprecated since 1.3.0
1193
- "SYNCHRONOUS_DYNAMODB_EVENTS" , # deprecated since 1.3.0
1194
- "SYNCHRONOUS_API_GATEWAY_EVENTS" , # deprecated since 1.3.0
1195
- "SYNCHRONOUS_SQS_EVENTS" , # deprecated since 1.3.0
1196
- "KINESIS_PROVIDER" , # deprecated since 1.3.0
1197
+ "USE_SINGLE_REGION" , # deprecated since 0.12.7
1197
1198
"MOCK_UNIMPLEMENTED" , # deprecated since 1.3.0
1198
1199
]
1199
1200
0 commit comments