Skip to content

Conversation

@billkable
Copy link
Contributor

Initial draft of public terraform modules release announcement and quick start.

@billkable
Copy link
Contributor Author

billkable commented Jun 5, 2025

@jorgemoralespou please review current draft.

note the terraform apply asciinema needs a re-record - encountered a failure on initial kapp controller deployment, see educates/educates-terraform-modules#14

Copy link
Contributor

@jorgemoralespou jorgemoralespou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, it's good, although I would make more emphasis, as stated in my comments to the fact that, what we support and release are the individual modules, and that what's in root_modules is a inspirational implementation.

7. **Educates CLI**:
We'll need to deploy/manage a workshop to verify the cluster by either method:
- Download the [Educates CLI directly](https://github.com/educates/educates-training-platform/releases/tag/3.3.2),
- Use the [Educatesenv tool to manage the installation of Educates](../blog/managing-multiple-versions-of-educates-cli).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make this a global link, so /blog/managing-multiple-versions-of-educates-cli

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you prefer to install Educates via the CLI as in [Installing Educates on a cloud provider article](../blog/install-educates-cloud-cli),
set the `deploy_educates` flag to `false`.
The Educates module will not be deployed.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a note that, while this modules are a convenience or reference implementation, what we're really releasing are the independent modules that can be consumed in your own custom terraform plans. In that case, one should use the whole tag version of the module, like this:
source = "github.com/educates/educates-terraform-modules.git//infrastructure/gke-for-educates?ref=v1.0.2"

And that these are the modules that are really released and versioned, and the changes are documented in the release page at https://github.com/educates/educates-terraform-modules/releases

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jorgemoralespou see latest commit updates, main theme is to expand and differentiate about infrastructure, platform and root modules.


State of the terraform plan and the associated cluster deployment workflow is not automatically saved elsewhere,
so if you were to modify or delete these resources,
you would not be able to update or destroy your cluster using Terraform.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add:

This is one of the reasons these are just example reference implementations, and it's up to you to know what you're doing. You should use the released modules in your own plans, taking inspiration from these reference implementations, but guaranteeing to properly save the state of your plan executions.

Or something the likes

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jorgemoralespou this section is also added in latest.

@billkable
Copy link
Contributor Author

@jorgemoralespou the terraform-apply.cast is fixed too.

@billkable billkable force-pushed the add-terraform-quickstart-blog branch from 4d63921 to b8a360d Compare June 5, 2025 15:14
@jorgemoralespou jorgemoralespou merged commit 82d49a3 into educates:develop Jun 5, 2025
1 check passed
@jorgemoralespou jorgemoralespou deleted the add-terraform-quickstart-blog branch June 5, 2025 15:20
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.

2 participants