Skip to content

Commit

Permalink
Merge branch 'release-24-06' into 'main'
Browse files Browse the repository at this point in the history
Release 24 06

See merge request cloudsolutions/automation-templates/f5-aws-cloudformation-v2!201
  • Loading branch information
mikeshimkus committed Jun 7, 2024
2 parents 808bc27 + 27a682c commit 64d252c
Show file tree
Hide file tree
Showing 74 changed files with 306 additions and 306 deletions.
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ test_policy_check:

run_sync_at_metadata:
echo "Syncing AT component metadata"
cd ${SYNC_AT_DIR} && ./sync_at_components_metadata.sh --config-directories ../../examples/autoscale/bigip-configurations,../../examples/quickstart/bigip-configurations,../../examples/failover/bigip-configurations --template-directory ../../examples --runtime-init-package-url https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v2.0.1/dist/f5-bigip-runtime-init-2.0.1-1.gz.run --cloud aws
cd ${SYNC_AT_DIR} && ./sync_at_components_metadata.sh --config-directories ../../examples/autoscale/bigip-configurations,../../examples/quickstart/bigip-configurations,../../examples/failover/bigip-configurations --template-directory ../../examples --runtime-init-package-url https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v2.0.2/dist/f5-bigip-runtime-init-2.0.2-1.gz.run --cloud aws

run_parameter_generator:
echo "Generating v2 input parameters files"
Expand Down
2 changes: 1 addition & 1 deletion cloud-tools
4 changes: 2 additions & 2 deletions examples/DEPLOYMENT-TRAFFIC-FLOWS.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,11 +114,11 @@ Examples in bold are what you would need to edit to a reachable endpoint if you
```json
{
"ParameterKey": "bigIpRuntimeInitConfig01",
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/failover/bigip-configurations/runtime-init-conf-3nic-payg-instance01-with-app.yaml"
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/failover/bigip-configurations/runtime-init-conf-3nic-payg-instance01-with-app.yaml"
},
{
"ParameterKey": "bigIpRuntimeInitConfig02",
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/failover/bigip-configurations/runtime-init-conf-3nic-payg-instance02-with-app.yaml"
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/failover/bigip-configurations/runtime-init-conf-3nic-payg-instance02-with-app.yaml"
},
{
"ParameterKey": "bigIpRuntimeInitPackageUrl",
Expand Down
2 changes: 1 addition & 1 deletion examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ OR
For example:
```bash
aws cloudformation create-stack --region us-east-1 --stack-name myStack \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/quickstart/quickstart.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/quickstart/quickstart.yaml \
--parameters "ParameterKey=sshKey,ParameterValue=MY-SSH-KEY-NAME ParameterKey=restrictedSrcAddressMgmt,ParameterValue=55.55.55.55/32 ParameterKey=restrictedSrcAddressApp,ParameterValue=0.0.0.0/0"
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,11 +50,11 @@ bigip_ready_enabled: []
extension_packages:
install_operations:
- extensionType: do
extensionVersion: 1.43.0
extensionHash: 394f6d97219d016e90016874acb09bd27f7907fda4f1730dea0276900b753a1d
extensionVersion: 1.44.0
extensionHash: 3b05d9bcafbcf0b5b625ff81d6bab5ad26ed90c0dd202ded51756af3598a97ec
- extensionType: as3
extensionVersion: 3.50.2
extensionHash: 620f441bebfdce0261045e34bc7c34f2793b05c0aca62c7ec8e22bbb3f4f35c3
extensionVersion: 3.51.0
extensionHash: e151a9ccd0fd60c359f31839dc3a70bfcf2b46b9fedb8e1c37e67255ee482c0f
- extensionType: ts
extensionVersion: 1.35.0
extensionHash: 839698d98a8651a90b3d509cde4b382338461a253878c9fd00c894699ef0e844
Expand Down Expand Up @@ -183,7 +183,7 @@ extension_services:
Custom_WAF_Policy:
class: WAF_Policy
url: >-
https://raw.githubusercontent.com/F5Networks/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/Rapid_Deployment_Policy_13_1.xml
https://raw.githubusercontent.com/F5Networks/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/Rapid_Deployment_Policy_13_1.xml
enforcementMode: blocking
ignoreChanges: false
HTTP_Service:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,11 @@ bigip_ready_enabled: []
extension_packages:
install_operations:
- extensionType: do
extensionVersion: 1.43.0
extensionHash: 394f6d97219d016e90016874acb09bd27f7907fda4f1730dea0276900b753a1d
extensionVersion: 1.44.0
extensionHash: 3b05d9bcafbcf0b5b625ff81d6bab5ad26ed90c0dd202ded51756af3598a97ec
- extensionType: as3
extensionVersion: 3.50.2
extensionHash: 620f441bebfdce0261045e34bc7c34f2793b05c0aca62c7ec8e22bbb3f4f35c3
extensionVersion: 3.51.0
extensionHash: e151a9ccd0fd60c359f31839dc3a70bfcf2b46b9fedb8e1c37e67255ee482c0f
- extensionType: ts
extensionVersion: 1.35.0
extensionHash: 839698d98a8651a90b3d509cde4b382338461a253878c9fd00c894699ef0e844
Expand Down Expand Up @@ -161,7 +161,7 @@ extension_services:
Custom_WAF_Policy:
class: WAF_Policy
url: >-
https://raw.githubusercontent.com/F5Networks/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/Rapid_Deployment_Policy_13_1.xml
https://raw.githubusercontent.com/F5Networks/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/Rapid_Deployment_Policy_13_1.xml
enforcementMode: blocking
ignoreChanges: false
HTTP_Service:
Expand Down
28 changes: 14 additions & 14 deletions examples/autoscale/bigiq/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ This solution leverages more traditional Autoscale configuration management prac
| application | No | f5app | string | Application Tag. |
| appScalingMaxSize | No | 50 | string | Maximum number of Application instances (2-50) that can be created in the Autoscale Group. |
| appScalingMinSize | No | 1 | string | Minimum number of Application instances (1-49) you want available in the Autoscale Group. |
| artifactLocation | No | f5-aws-cloudformation-v2/v3.4.0.0/examples/ | string | The path in the S3Bucket where the modules folder is located. |
| artifactLocation | No | f5-aws-cloudformation-v2/v3.5.0.0/examples/ | string | The path in the S3Bucket where the modules folder is located. |
| bastionScalingMaxSize | No | 2 | string | Maximum number of Bastion instances (2-10) that can be created in the Autoscale Group. |
| bastionScalingMinSize | No | 1 | string | Minimum number of Bastion instances (1-9) you want available in the Autoscale Group. |
| bigIpCustomImageId | No | | string | Provide BIG-IP AMI ID you wish to deploy. bigIpCustomImageId is required when bigIpImage is not specified. Otherwise, can leave empty. |
Expand All @@ -170,7 +170,7 @@ This solution leverages more traditional Autoscale configuration management prac
| bigIpMaxBatchSize | No | 5 | string | Specifies the maximum number of instances that CloudFormation updates. |
| bigIpMinInstancesInService | No | 1 | string | Specifies the minimum number of instances that must be in service within the Auto Scaling group while CloudFormation updates old instances. |
| bigIpPauseTime | No | 480 | string | The amount of time in seconds that CloudFormation pauses after making a change to a batch of instances to give those instances time to start software applications. |
| bigIpRuntimeInitConfig | No | https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml | string | IMPORTANT: For this solution, this parameter should be customized. Enter a URL to the bigip-runtime-init configuration file in YAML or JSON format. See [Changing the BIG-IP Deployment](#changing-the-big-ip-deployment) for more details.|
| bigIpRuntimeInitConfig | No | https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml | string | IMPORTANT: For this solution, this parameter should be customized. Enter a URL to the bigip-runtime-init configuration file in YAML or JSON format. See [Changing the BIG-IP Deployment](#changing-the-big-ip-deployment) for more details.|
| bigIpRuntimeInitPackageUrl | No | https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v1.5.0/dist/f5-bigip-runtime-init-1.5.0-1.gz.run | string | Enter a URL to the bigip-runtime-init package. |
| bigIpScaleInCpuThreshold | No | 20 | string | Low CPU Percentage threshold to begin scaling in BIG-IP VE instances. |
| bigIpScaleInThroughputThreshold | No | 10000000 | string | Incoming bytes threshold to begin scaling in BIG-IP VE instances. |
Expand Down Expand Up @@ -237,7 +237,7 @@ This solution leverages more traditional Autoscale configuration management prac
| application | No | f5app | string | Application Tag. |
| appScalingMaxSize | No | 50 | string | Maximum number of Application instances (2-50) that can be created in the Autoscale Group. |
| appScalingMinSize | No | 1 | string | Minimum number of Application instances (1-49) you want available in the Autoscale Group. |
| artifactLocation | No | f5-aws-cloudformation-v2/v3.4.0.0/examples/ | string | The path in the S3Bucket where the modules folder is located. |
| artifactLocation | No | f5-aws-cloudformation-v2/v3.5.0.0/examples/ | string | The path in the S3Bucket where the modules folder is located. |
| bastionScalingMaxSize | No | 2 | string | Maximum number of Bastion instances (2-10) that can be created in the Autoscale Group. |
| bastionScalingMinSize | No | 1 | string | Minimum number of Bastion instances (1-9) you want available in the Autoscale Group. |
| bigIpCustomImageId | No | | string | Provide BIG-IP AMI ID you wish to deploy. bigIpCustomImageId is required when bigIpImage is not specified. Otherwise, can leave empty. |
Expand All @@ -247,7 +247,7 @@ This solution leverages more traditional Autoscale configuration management prac
| bigIpMaxBatchSize | No | 5 | string | Specifies the maximum number of instances that CloudFormation updates. |
| bigIpMinInstancesInService | No | 1 | string | Specifies the minimum number of instances that must be in service within the Auto Scaling group while CloudFormation updates old instances. |
| bigIpPauseTime | No | 480 | string | The amount of time in seconds that CloudFormation pauses after making a change to a batch of instances to give those instances time to start software applications. |
| bigIpRuntimeInitConfig | No | https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml | string | Enter a URL to the bigip-runtime-init configuration file in YAML or JSON format. |
| bigIpRuntimeInitConfig | No | https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml | string | Enter a URL to the bigip-runtime-init configuration file in YAML or JSON format. |
| bigIpRuntimeInitPackageUrl | No | https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v1.5.0/dist/f5-bigip-runtime-init-1.5.0-1.gz.run | string |Enter a URL to the bigip-runtime-init package. |
| bigIpScaleInCpuThreshold | No | 20 | string | Low CPU Percentage threshold to begin scaling in BIG-IP VE instances. |
| bigIpScaleInThroughputThreshold | No | 10000000 | string | Incoming bytes threshold to begin scaling in BIG-IP VE instances. |
Expand Down Expand Up @@ -322,11 +322,11 @@ An easy first way to deploy this solution is to use the deploy button below. How
**NOTE**: By default, the link takes you to an AWS console set to the us-east-1 region. Select the AWS region (upper right) in which you want to deploy after clicking the Launch Stack button.

**Full Stack**
<a href="https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=BigIp-Autoscale-WAF-Example&templateURL=https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml">
<a href="https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=BigIp-Autoscale-WAF-Example&templateURL=https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml">
<img src="https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png"/></a>

**Existing Stack**
<a href="https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=BigIp-Autoscale-WAF-Example&templateURL=https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale-existing-network.yaml">
<a href="https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=BigIp-Autoscale-WAF-Example&templateURL=https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale-existing-network.yaml">
<img src="https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png"/></a>


Expand Down Expand Up @@ -364,15 +364,15 @@ By default, the templates in this repository are also publicly hosted on S3 at [

```bash
aws cloudformation create-stack --region ${REGION} --stack-name ${STACK_NAME} \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters "ParameterKey=<KEY>,ParameterValue=<VALUE> ParameterKey=<KEY>,ParameterValue=<VALUE>" \
--capabilities CAPABILITY_NAMED_IAM
```

or with a local parameters file (see `autoscale-parameters.json` example in this directory):
```bash
aws cloudformation create-stack --region us-east-1 --stack-name mywaf \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters file://autoscale-parameters.json \
--capabilities CAPABILITY_NAMED_IAM
```
Expand All @@ -382,14 +382,14 @@ Example:
**Full Stack**
```bash
aws cloudformation create-stack --region us-east-1 --stack-name mywaf \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters "ParameterKey=sshKey,ParameterValue=MY_SSH_KEY_NAME ParameterKey=restrictedSrcAddressMgmt,ParameterValue=55.55.55.55/32 ParameterKey=restrictedSrcAddressApp,ParameterValue=0.0.0.0/0 ParameterKey=uniqueString,ParameterValue=mywaf ParameterKey=bigIqAddressType,ParameterValue=public ParameterKey=bigIqSecretArn ParameterValue=arn:aws:secretsmanager:us-east-1:111111111111:secret:myBigIqSecret-xdg0kdf ParameterKey=bigIpRuntimeInitConfig,ParameterValue=https://raw.githubusercontent.com/myAccount/myRepo/0.0.1/runtime-init.conf" \
--capabilities CAPABILITY_NAMED_IAM
```
**Existing Stack**
```bash
aws cloudformation create-stack --region us-east-1 --stack-name mywaf \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale-existing-network.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale-existing-network.yaml \
--parameters "ParameterKey=sshKey,ParameterValue=MY_SSH_KEY_NAME ParameterKey=restrictedSrcAddressMgmt,ParameterValue=55.55.55.55/32 ParameterKey=restrictedSrcAddressApp,ParameterValue=0.0.0.0/0 ParameterKey=uniqueString,ParameterValue=mywaf ParameterKey=bigIqAddressType,ParameterValue=public ParameterKey=bigIqSecretArn ParameterValue=arn:aws:secretsmanager:us-east-1:111111111111:secret:myBigIqSecret-xdg0kdf ParameterKey=bigIpRuntimeInitConfig,ParameterValue=https://raw.githubusercontent.com/myAccount/myRepo/0.0.1/runtime-init.conf ParameterKey=bigIpSubnetAz1,ParameterValue=<SUBNET ID> ParameterKey=bigIpSubnetAz2,ParameterValue=<SUBNET ID> ParameterKey=vpcId,ParameterValue=<VPC ID>" \
--capabilities CAPABILITY_NAMED_IAM
```
Expand All @@ -406,7 +406,7 @@ Example from autoscale-parameters.json
```json
{
"ParameterKey": "bigIpRuntimeInitConfig",
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml"
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml"
},
```

Expand Down Expand Up @@ -821,7 +821,7 @@ To update the BIG-IP configuration:
4. Update the CloudFormation Stack with the new **bigIpRuntimeInitConfig** parameter:
```bash
aws cloudformation update-stack --region ${REGION} --stack-name ${STACK_NAME} \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters "ParameterKey=bigIpRuntimeInitConfig,ParameterValue=https://<YOUR_NEW_LOCATION> ParameterKey=<KEY>,ParameterValue=<VALUE>"
```
Expand All @@ -831,7 +831,7 @@ To update the BIG-IP OS version:
1. Update the CloudFormation Stack with new **imageName** parameter:
```bash
aws cloudformation update-stack --region ${REGION} --stack-name ${STACK_NAME} \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters "ParameterKey=imageName,ParameterValue=${imageName} ParameterKey=<KEY>,ParameterValue=<VALUE>"
```
Expand All @@ -840,7 +840,7 @@ To update the BIG-IP instance size:
2. Update the CloudFormation Stack with new **instanceType** parameter:
```bash
aws cloudformation update-stack --region ${REGION} --stack-name ${STACK_NAME} \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigiq/autoscale.yaml \
--template-url https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigiq/autoscale.yaml \
--parameters "ParameterKey=instanceSize,ParameterValue=${instanceType} ParameterKey=<KEY>,ParameterValue=<VALUE>"
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
},
{
"ParameterKey": "artifactLocation",
"ParameterValue": "f5-aws-cloudformation-v2/v3.4.0.0/examples/"
"ParameterValue": "f5-aws-cloudformation-v2/v3.5.0.0/examples/"
},
{
"ParameterKey": "bigIpSubnetAz1",
Expand Down Expand Up @@ -65,11 +65,11 @@
},
{
"ParameterKey": "bigIpRuntimeInitConfig",
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.4.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml"
"ParameterValue": "https://f5-cft-v2.s3.amazonaws.com/f5-aws-cloudformation-v2/v3.5.0.0/examples/autoscale/bigip-configurations/runtime-init-conf-bigiq-with-app.yaml"
},
{
"ParameterKey": "bigIpRuntimeInitPackageUrl",
"ParameterValue": "https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v2.0.1/dist/f5-bigip-runtime-init-2.0.1-1.gz.run"
"ParameterValue": "https://cdn.f5.com/product/cloudsolutions/f5-bigip-runtime-init/v2.0.2/dist/f5-bigip-runtime-init-2.0.2-1.gz.run"
},
{
"ParameterKey": "bigIpScaleInCpuThreshold",
Expand Down
Loading

0 comments on commit 64d252c

Please sign in to comment.