-
Notifications
You must be signed in to change notification settings - Fork 213
docs/dev: Second level operator FAQ #34
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
Conversation
|
@wking Feedback please. |
wking
left a comment
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.
Looks good to me. A few minor nits inline.
docs/dev/operators.md
Outdated
|
|
||
| In your deployment you can reference the latest development version of your operator image (quay.io/openshift/origin-machine-api-operator:latest). If you have other hard-coded image strings, try to put them as environment variables on your deployment or as a config map. | ||
|
|
||
| Your manifests will be applied in alphabetical order by the CVO, so name your files in the order you want them run. |
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.
Shift this line into the next section?
docs/dev/operators.md
Outdated
|
|
||
| Your manifests will be applied in alphabetical order by the CVO, so name your files in the order you want them run. | ||
|
|
||
| ### Names of manifest files: |
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.
You can drop the trailing colon.
docs/dev/operators.md
Outdated
| 99_ingress-operator_01_roles.yaml | ||
| 99_ingress-operator_02_deployment.yaml | ||
|
|
||
| ## How do I get added as a special run level? |
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.
This belongs as a sibling of the previous subsection, since it discusses /manifests content. It should be a ### header.
docs/dev/operators.md
Outdated
| ## How do I ensure the right images get used by my manifests? | ||
| Your manifests can contain a tag to the latest development image published by Origin. You’ll annotate your manifests by creating a file that identifies those images. | ||
|
|
||
| Assume you have two images in your manifests - “quay.io/openshift/origin-ingress-operator:latest” and “quay.io/openshift/origin-haproxy-router:latest”. Those correspond to the following tags “ingress-operator” and “haproxy-router” when the CI runs. |
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.
These image names and tags should probably be backticked instead of being curly-quoted.
bc1185c to
9cbd960
Compare
|
@wking All feedback incorporated. Thanks. |
|
/lgtm |
|
/test e2e-aws |
crawford
left a comment
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.
One small NIT.
docs/dev/operators.md
Outdated
|
|
||
| 0000_<runlevel>_<dash-separated_component>-<manifest_filename> | ||
|
|
||
| For example, the Kube core operators run in runlevel 10 and have filenames like |
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.
For example, the Kube operators run in runlevels 10-19 and have filenames like
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.
Fixed.
New document/guide in the form of a detailed FAQ for operator authors wanting to integrate their operators with the cluster payload generated by CVO.
|
/lgtm |
|
/lgtm |
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: abhinavdahiya, crawford, rajatchopra, wking The full list of commands accepted by this bot can be found here. The pull request process is described here DetailsNeeds approval from an approver in each of these files:
Approvers can indicate their approval by writing |
It feels like the wording wanted this to be an enumerated list, but the text landed without that markup in e046cd7 (docs/dev: Second level operator FAQ, 2018-10-08, openshift#34).
New document/guide in the form of a detailed FAQ for operator authors wanting to integrate their operators with the cluster payload generated by CVO.
Excerpted from internal documentation.