-
Notifications
You must be signed in to change notification settings - Fork 199
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
Granulate gMaestro Addon #727
Granulate gMaestro Addon #727
Conversation
@marina-vrublevsky a couple of questions:
|
@marina-vrublevsky Also please fix the Pattern aws-samples/cdk-eks-blueprints-patterns#57 for Granulate. |
Hi @elamaran11
Yes
Done
On it |
@elamaran11 please review aws-samples/cdk-eks-blueprints-patterns#101 |
@marina-vrublevsky Have few comments on the Patterns PR, please address it. Once we have patterns PR merged, we can review this doc PR. |
@marina-vrublevsky Please provide an update on this PR and Patterns Repo PR. |
1 similar comment
@marina-vrublevsky Please provide an update on this PR and Patterns Repo PR. |
@marina-vrublevsky I am picking this review up from Ela. I don't see a lib/addons/gmaestro/index.ts file, is there a reason for that? I see this PR is open for a while. Happy to support to get to completion. Please respond thanks. |
82c8336
to
e057297
Compare
docs/addons/gmaestro.md
Outdated
--description "Encrypted client ID for Granulate gMaestro" \ | ||
--secret-string "${MAESTRO_CLIENT_ID}" | ||
``` | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would replace the above with:
3. Create a secret (as a plaintext) in AWS Secrets Manager:
bash export MAESTRO_CLIENT_ID=<MAESTRO_CLIENT_ID value from the Deployment section in the downloaded config file> export MAESTRO_SECRET_NAME=<your preferred secret name> aws secretsmanager create-secret --name ${MAESTRO_SECRET_NAME} \ --description "Encrypted client ID for Granulate gMaestro" \ --secret-string "${MAESTRO_CLIENT_ID}"
docs/addons/gmaestro.md
Outdated
const app = new cdk.App(); | ||
|
||
const addOn = new GmaestroAddOn({ | ||
clientIdSecretName: "<secret name>", // MAESTRO_SECRET_NAME |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
is clientIdSecretName a good parameter name? should it be more appropriate secretName? It is a bit confusing seems a merge between MAESTRO_SECRET_NAME and MAESTRO_CLIENT_ID
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
approving following discussions and amendments on other channel
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@marina-vrublevsky Nice work, couple of minor changes from documentation perspective. Also fix the GH action errors, i see missing Doc links.
docs/addons/gmaestro.md
Outdated
## Prerequisites | ||
Before using gMaestro, you need to: | ||
1. [Sign up](https://app.granulate.io/gMaestroSignup) to the gMaestro platform | ||
2. Download a sample YAML file - After signing up to gMaestro, navigate to the [Deploy](https://app.granulate.io/deploy) on the left-hand menu, fill in the required fields and click on "Generate Config File" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we have a place to download the sample YAML. If not i would add the sample YAML to this doc page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The only way to download it is using the instruction, I would rather not add it to the doc since it's being maintained by us and might change frequently
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would atleast hyperlink from where to download the sample, when you say Download a sample YAML file
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@elamaran11 I went through the signup process, I think the doc here is clear: there is an image right below line 9 here that shows where to tap to download the file
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oh it wasn't clear initially, it makes sense. So you mean download as shown in below image. I would rather say Download a sample YAML file from step 3 - Download Config File
as shown below. But up to you. Im good.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i can't provide a direct hyper link since it's auto generated after you follow the instructions in: https://app.granulate.io/deploy
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think im good on this comment. All i was recommending at last is rephrasing your sentence to say Download a sample YAML file from step 3 - Download Config File as shown below
and hyperlink is not needed.
docs/addons/gmaestro.md
Outdated
@@ -0,0 +1,67 @@ | |||
# gMaestro add-on for Amazon EKS Blueprints | |||
|
|||
The gMaestro Blueprints AddOn deploys the gMaestro Agent on Amazon EKS using the [eks-blueprints](https://github.com/aws-quickstart/cdk-eks-blueprints) [CDK](https://aws.amazon.com/cdk/) construct. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would rather remove this - using the eks-blueprints CDK construct.
and rephrase the sentence better to say what the addon actually does apart from deploying the agent on Amazon EKS. You need one or two sentence to explain what the addon does?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@marina-vrublevsky Couple of minor feedback almost there. Nice work~
mkdocs.yml
Outdated
@@ -79,6 +79,7 @@ nav: | |||
- Vpc Cni: 'addons/vpc-cni.md' | |||
- AWS XRay: 'addons/xray.md' | |||
- AWS XRay ADOT: 'addons/xray-adot-addon.md' | |||
- Gmaestro: 'addons/gmaestro.md' |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Move this to after line 48.
@elamaran11 I believe I addressed all your comments, can you please re-review both PRs? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
@marina-vrublevsky Please see the above GH failures and fix those. Did you pull the latest code, some changes in main should be missed. |
@elamaran11 I'm merged, looks like the error is unrelated to me |
@marina-vrublevsky Totally agree its not your issue, rather than we fixing it your pulling it again from main. Can you replace this file |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
Waiting on Patterns Repo PR to merge this. |
Issue #, if available:
Description of changes:
This PR continues #576
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.