Skip to content

Latest commit

 

History

History
31 lines (24 loc) · 1.5 KB

CONTRIBUTING.md

File metadata and controls

31 lines (24 loc) · 1.5 KB

Contributor instructions

Testing

Manual testing

To test the module manually, follow these steps:

  1. Login to the AWS console.
  2. Create an Amazon RDS instance.
  3. Copy the terraform.tfvars.example file to terraform.tfvars:
    cp terraform.tfvars.example terraform.tfvars
    
  4. Update the values in terraform.tfvars to match your cluster.
  5. Create the resources:
    terraform apply
    
  6. After the resources have been created, go to the Target Groups in the AWS console and make sure that the health checks are passing. If they are not, you will need to add the subnet CIDR blocks of your RDS instance to the security groups of your RDS instance. For more information, see this AWS documentation.
  7. Next, run the queries in the output to create the connection in Materialize.
  8. Finally, in your AWS console, under the Endpoint Service that was created, approve the connection request from the Materialize instance and check that the connection is active.
  9. You can now create a Postgres source in Materialize using the connection name from the output.
  10. Finally, drop the connection in Materialize and run terraform destroy to clean up the resources.

Cutting a new release

Perform a manual test of the latest code on main. See prior section. Then run:

git tag -a vX.Y.Z -m vX.Y.Z
git push origin vX.Y.Z