Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat!: Simplify use of the all_ports argument #132

Merged
merged 13 commits into from May 2, 2024

Conversation

colereynolds
Copy link
Contributor

@colereynolds colereynolds commented Feb 15, 2024

Today, the ports argument is required and no mention of exclusivity between the ports and all_ports argument is mentioned in the variable description or Terraform Registry docs for this module. If someone wants to use the all_ports argument, they have to go through a process of trial and error to figure out what value to pass to the ports argument in order to successfully deploy the forwarding rule. I'm proposing to make the ports argument optional and set the default value to null, which is the only value the backend API will accept to deploy the forwarding rule when all_ports is set to true.

I can't find where to update the Terraform Registry docs for this module. Adding more detail around the mutual exclusivity of the ports and all_ports arguments[1] would help users understand that only one of the two should be used, if someone could make time to create an issue for that, please.

[1] https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_forwarding_rule.html#all_ports

@colereynolds colereynolds requested review from imrannayer and a team as code owners February 15, 2024 17:29
Copy link

google-cla bot commented Feb 15, 2024

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@imrannayer
Copy link
Collaborator

/gcbrun

@imrannayer
Copy link
Collaborator

/gcbrun

@imrannayer imrannayer changed the title Fix: Simplify use of the all_ports argument feat: Simplify use of the all_ports argument Apr 5, 2024
@imrannayer imrannayer changed the title feat: Simplify use of the all_ports argument feat!: Simplify use of the all_ports argument Apr 5, 2024
@imrannayer
Copy link
Collaborator

@colereynolds since we are changing default behavior it has to be a breaking change. Can you plz add a document mentioning this behavior change in doc folder? use this doc as example. Create one for version 6.0.

@imrannayer
Copy link
Collaborator

@colereynolds r u still working on this?

@colereynolds
Copy link
Contributor Author

colereynolds commented Apr 29, 2024

@imrannayer Yes, I haven't forgotten about this. I have been in a very busy season but things are getting back to normal. I will make time to do this sometime this week.

@imrannayer imrannayer self-assigned this Apr 30, 2024
Updated Upgrading section to include new doc
Mentioning the exclusivity between ports and all_ports in variable descriptions
Added upgrade doc for v6
Update variable descriptions to mention mutual exclusivity of port and all_ports arguments
Update usage example with a working example
Update variable descriptions
Removing range from ports argument description as it's misleading
@colereynolds
Copy link
Contributor Author

colereynolds commented May 2, 2024

@imrannayer - Give this another look when you get a few. I made a few tweaks to update the README too.

@imrannayer
Copy link
Collaborator

/gcbrun

@imrannayer
Copy link
Collaborator

/gcbrun

@imrannayer imrannayer merged commit e25dbbc into terraform-google-modules:master May 2, 2024
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants