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

Doc updates for README and Getting Started guide #413

Merged
merged 5 commits into from
Apr 18, 2022

Conversation

kcoleman731
Copy link
Contributor

What does this PR do?

Documentation updates. Readme, getting started guide, and a few other doc pages.

Motivation

More

  • Yes, I have tested the PR using my local account setup (Provide any test evidence report under Additional Notes)
  • Yes, I have added a new example under examples to support my PR
  • Yes, I have created another PR for add-ons under add-ons repo (if applicable)
  • Yes, I have updated the docs for this feature
  • Yes, I ran pre-commit run -a with this PR

Note: Not all the PRs required examples and docs except a new pattern or add-on added.

For Moderators

  • E2E Test successfully complete before merge?

Additional Notes

Copy link
Contributor

@askulkarni2 askulkarni2 left a comment

Choose a reason for hiding this comment

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

looking great!

README.md Outdated
managed_node_groups = {
mg_m4l = {
node_group_name = "managed-ondemand"
instance_types = ["m4.large"]
Copy link
Contributor

Choose a reason for hiding this comment

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

Lets use m5 instances as they are the latest.

README.md Outdated
module "eks-blueprints" {
source = "github.com/aws-ia/terraform-aws-eks-blueprints"
module "eks_blueprints" {
source = "github.com/aws-ia/terraform-aws-eks-blueprints"
Copy link
Contributor

Choose a reason for hiding this comment

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

pin the version

Copy link
Contributor

Choose a reason for hiding this comment

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

Now now. We can do this when we register our module with Terraform Registry. We can simply introduce a version variable to docs and examples

README.md Outdated

depends_on = [module.eks-blueprints.managed_node_groups]
module "eks_blueprints_kubernetes_addons" {
source = "github.com/aws-ia/terraform-aws-eks-blueprints//modules/kubernetes-addons"
Copy link
Contributor

Choose a reason for hiding this comment

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

pin version

Copy link
Contributor

Choose a reason for hiding this comment

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

same as my above comment

```shell script
terraform apply
```
terraform apply -target="module.aws_vpc"
Copy link
Contributor

Choose a reason for hiding this comment

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

👍🏽

Copy link
Contributor

@vara-bonthu vara-bonthu left a comment

Choose a reason for hiding this comment

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

LGTM! Few comments

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@@ -49,40 +49,42 @@ In order to deploy an add-on with default configuration, simply enable the add-o

```hcl
module "eks-blueprints-kubernetes-addons" {
Copy link
Contributor

Choose a reason for hiding this comment

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

we can change the module names to use underscore (_) instead of hyphen (-) as a best practise and be consistent with TF standards. This might need changing in many other places as well


See our [`Teams`](./teams) documentation page for detailed information.

## Application

`Applications` represent the actual workloads that run within a Kubernetes cluster. The framework leverages a GitOps approach for deploying applications onto clusters.

See our [`Applications](https://github.com/aws-ia/terraform-aws-eks-blueprints/blob/main/docs/add-ons/argocd.md#boostrapping) documentation for detailed information.
See our [`Applications](./add-ons/argocd.md#boostrapping) documentation for detailed information.
Copy link
Contributor

Choose a reason for hiding this comment

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

We can keep this as full link to github pages. See my comments above

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
docs/add-ons/index.md Outdated Show resolved Hide resolved
docs/add-ons/index.md Outdated Show resolved Hide resolved
docs/add-ons/index.md Outdated Show resolved Hide resolved
docs/core-concepts.md Outdated Show resolved Hide resolved
docs/core-concepts.md Outdated Show resolved Hide resolved
docs/core-concepts.md Outdated Show resolved Hide resolved
docs/getting-started.md Outdated Show resolved Hide resolved
kcaws and others added 3 commits April 17, 2022 22:06
Updating doc paths

Co-authored-by: Bryant Biggs <bryantbiggs@gmail.com>
Co-authored-by: Vara Bonthu <vara.bonthu@gmail.com>
@kcoleman731 kcoleman731 force-pushed the feature/doc-updates-readme-getting-started branch from c05728e to 7314c13 Compare April 18, 2022 05:07
@kcoleman731 kcoleman731 force-pushed the feature/doc-updates-readme-getting-started branch from 686305b to a86264f Compare April 18, 2022 05:09
@kcoleman731 kcoleman731 marked this pull request as ready for review April 18, 2022 17:09
@bryantbiggs bryantbiggs merged commit 3492123 into main Apr 18, 2022
@bryantbiggs bryantbiggs deleted the feature/doc-updates-readme-getting-started branch April 18, 2022 20:52
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

5 participants