Skip to content
This repository was archived by the owner on Jul 19, 2023. It is now read-only.

Polish Helm charts #76

Merged
merged 13 commits into from
Jan 23, 2020
Merged

Polish Helm charts #76

merged 13 commits into from
Jan 23, 2020

Conversation

RedbackThomson
Copy link
Contributor

Polished the Helm charts to ensure they meet the quality of the latest Helm version.

Biggest change is that namespace, in Helm 3, is controlled at installation time. Users are now required to list --namespace <namespace> when installing the chart. Therefore our documentation must match this new installation method to ensure the operator runs in an appropriate namespace.

Modified all the variables to be in camelCase.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@@ -1,7 +1,7 @@
apiVersion: v1
name: sagemaker-k8s-trainingjob
version: 0.1.0
description: A Helm chart for deploying the SageMaker TrainingJob for Kubernetes.
description: A Helm chart for deploying a SageMaker TrainingJob from Kubernetes.
Copy link
Contributor

Choose a reason for hiding this comment

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

We should add appVersion to all, or none.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

To me it didn't make sense to have an "appVersion" on the jobs, since they don't necessarily correspond 1-to-1 with the controller. They will need to change if we make changes to the CRD specs, but I don't think this will be every release. Thoughts?

Copy link
Contributor

Choose a reason for hiding this comment

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

Ah, that makes sense. If anything we should have an appVersion that corresponds to our API types (v1). That way when v2 comes around the switch is easier? Does the helm tool itself use these annotations, or are they for humans?

Comment on lines 43 to 49
The following table lists the configurable parameters for the chart and their default values.

Parameter | Description | Default
--- | --- | ---
`rolesArn` | The EKS service account role ARN | `<PLACEHOLDER>`
`image.repository` | image repository | `957583890962.dkr.ecr.us-east-1.amazonaws.com/amazon-sagemaker-operator-for-k8s`
`image.tag` | image tag | `<VERSION>`
Copy link
Contributor

Choose a reason for hiding this comment

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

Should we leave out or complete? I think instead of providing an incomplete table we should just refer them to the spec?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is complete for the installer chart. These are the only values in the values.yaml file they are able to modify.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I left the README out of the specs since I would hope users refer to the documentation for the specification rather than a possibly out-of-date README.

Copy link
Contributor

Choose a reason for hiding this comment

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

I see, I got confused between charts.

I left the README out of the specs since I would hope users refer to the documentation for the specification rather than a possibly out-of-date README.

Can you restate? Do you mean to say that you did not include these installation steps in the spec itself?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I meant I did not include the README.md file in the training/hpo/batch charts since they use the same spec as the YAML charts, so it would be duplication of information that we would need to keep up-to-date.

Comment on lines +27 to +28
continuousParameterRanges: []
categoricalParameterRanges: []
Copy link
Member

Choose a reason for hiding this comment

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

This is todo ? @cadedaniel can u confirm that spec will work just that helm chart needs policing.

Copy link
Contributor

Choose a reason for hiding this comment

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

Yeah nick made a task for these https://issues.amazon.com/issues/P32170625

Install the operator using the following command:

```bash
kubectl create namespace sagemaker-k8s-operator-system
Copy link
Member

Choose a reason for hiding this comment

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

This should be optional and our installer.yaml should have sagemaker-k8s-operator-system as default namespace.

Copy link
Member

@goswamig goswamig left a comment

Choose a reason for hiding this comment

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

few minor comments otherwise LGTM.

@cadedaniel
Copy link
Contributor

Reminder to not merge this until PR in docs repo

@RedbackThomson
Copy link
Contributor Author

Merging alongside aws/sagemaker-python-sdk#1254

@RedbackThomson RedbackThomson merged commit 84ee9af into master Jan 23, 2020
@RedbackThomson RedbackThomson deleted the polish_helm branch January 23, 2020 23:13
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants