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

Add operator hub documentation #3158

Merged
merged 1 commit into from
May 14, 2020

Conversation

cdrage
Copy link
Member

@cdrage cdrage commented May 12, 2020

What type of PR is this?
/kind documentation
[skip ci]

What does does this PR do / why we need it:

Modifies the current operator hub documentation in the format as some of
the other tutorial documentation

Which issue(s) this PR fixes:

N/A

How to test changes / Special notes to the reviewer:

N/A

@cdrage
Copy link
Member Author

cdrage commented May 12, 2020

ping @dharmit @boczkowska

@openshift-ci-robot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please assign cdrage
You can assign the PR to them by writing /assign @cdrage in a comment when ready.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Copy link
Member

@dharmit dharmit left a comment

Choose a reason for hiding this comment

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

Wow, that's pretty major change compared to what I had in #3029! Requested some changes.

docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
docs/public/operator-hub.adoc Outdated Show resolved Hide resolved
**What type of PR is this?**
/kind documentation
[skip ci]

**What does does this PR do / why we need it**:

Modifies the current operator hub documentation in the format as some of
the other tutorial documentation

**Which issue(s) this PR fixes**:

N/A

**How to test changes / Special notes to the reviewer**:

N/A
@cdrage
Copy link
Member Author

cdrage commented May 13, 2020

Ready for another review @dharmit

@openshift-ci-robot
Copy link
Collaborator

@cdrage: The following tests failed, say /retest to rerun all failed tests:

Test name Commit Details Rerun command
ci/prow/v4.4-integration-e2e 75bc1f3 link /test v4.4-integration-e2e
ci/prow/v4.2-integration-e2e 75bc1f3 link /test v4.2-integration-e2e

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.

Here we can see some placeholder data in the form of `<etcd-cluster-endpoints>`
, `<aws-secret>` and `<full-s3-path>` that the user is expected to set to
appropriate value for the service to start.
It is important to note that `EtcdBackup` and `EtcdRestore` are **not** available for deployment as they require interactive parameters.
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 not entirely correct. I mean, one can't do odo service create etcdoperator.v0.9.4 --crd EtcdBackup or odo service create etcdoperator.v0.9.4 --crd EtcdRestore and expect it to work OOTB. They must redirect its alm-example to a yaml, modify the yaml to contain correct values and then use the --dry-run flag.

But, it's not worth holding this PR for that reason since --dry-run is properly documented already.

Copy link
Member Author

Choose a reason for hiding this comment

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

It's not entirely correct, but still a valid statement that they don't work out of the box. I don't think we should be encouraging users to have to modify a YAML, copy over metadata annotations and then try again.

Copy link
Member

Choose a reason for hiding this comment

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

I agree that we shouldn't be encouraging yaml modificatoin, but we're allowing them to pipe and edit a yaml while we get around to working on #2799 and #2785.

Copy link
Member

@dharmit dharmit left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci-robot openshift-ci-robot added the lgtm Indicates that a PR is ready to be merged. Required by Prow. label May 14, 2020
@cdrage
Copy link
Member Author

cdrage commented May 14, 2020

Mergin' since there's one LGTM / only one needed for docs!

@cdrage cdrage merged commit 99f1a2f into redhat-developer:master May 14, 2020
@cdrage cdrage deleted the update-operator-hub-docs branch January 14, 2022 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
lgtm Indicates that a PR is ready to be merged. Required by Prow.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants