Skip to content

Conversation

@samodell
Copy link
Contributor

@samodell samodell commented May 14, 2019

Fixes #1244

Proposed Changes

  • Adds a set of "default" instructions
  • Adds numbered steps
  • Moves installing-istio.md file from /serving/ to /install/

@samodell samodell added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 14, 2019
@samodell samodell requested a review from ZhiminXiang May 14, 2019 00:05
@knative-prow-robot knative-prow-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 14, 2019
@googlebot googlebot added the cla: yes Indicates the PR's author has signed the CLA. label May 14, 2019
@knative-prow-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: samodell

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

The pull request process is described 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

@knative-prow-robot knative-prow-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. approved labels May 14, 2019
Copy link
Contributor Author

@samodell samodell left a comment

Choose a reason for hiding this comment

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

Questions for @ZhiminXiang and @RichieEscarez

Wait a few seconds for the CRDs to be committed in the Kubernetes API-server,
then continue with these instructions.

1. Enter the following command to install Istio:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@ZhiminXiang

Is this the basic Istio installation we should recommend?

Bonus points -- is there a way to do our "basic" installation without using helm?

Choose a reason for hiding this comment

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

  1. The default command is exactly the same as the command in the section Installing Istio with sidecar injection. We should probably keep only one of them.
  2. We probably want to recommend users to use the instruction installing Istio with no sidecar injection as the default instructions. @tcnghia @mattmoor WDYT?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated to recommend no sidecar injection.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

And updated to go back to recommending automatic sidecar injection as the default, since I found info supporting that in the Custom Install guide, which I believe was reviewed by Matt and Nghia.

@knative-prow-robot knative-prow-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels May 14, 2019
@samodell
Copy link
Contributor Author

Opened #1319 to track additional work needed to update a few of the Install files which were doing unique things during the Istio install.

Otherwise, I think this is pretty good to go.

If you are just getting started with Knative, you should choose automatic
sidecar injection and enable the Istio service mesh.

Due to current dependencies, some installable Knative options require the Istio
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Are lines 51-53 still true? If they are, I would lean towards installing Istio with automatic sidecar injection as the default, since the majority of the install instructions right now tell people to install all the components as well as the observability plug-ins. I don't want to recommend a default that doesn't work for a lot of use cases...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Copy link

@ZhiminXiang ZhiminXiang May 14, 2019

Choose a reason for hiding this comment

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

@grantr
I guess in eventing side we are working on getting rid of mesh. I think Grant probably knows better about this part.

Copy link
Contributor

Choose a reason for hiding this comment

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

Eventing 0.6 no longer requires Istio. 🎉 @akashrv worked on this, so he knows the most about it.

Copy link
Contributor

Choose a reason for hiding this comment

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

That is correct. Eventing doesn't require Istio, but would continue to work with Istio mesh.

@samodell
Copy link
Contributor Author

Okay, @ZhiminXiang I switched the recommendation back to installing without sidecar injection.

Please let me know what you think and LGTM if you're happy with it!


When you install Istio, there are a few options depending on your goals. For a
basic Istio installation suitable for most Knative use cases, follow the
[Installing Istio with sidecar injection](#installing-istio-with-sidecar-injection)

Choose a reason for hiding this comment

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

nit: I think here it should be Installing Istio without sidecar injection

@ZhiminXiang
Copy link

Thanks @samodell . Generally it looks good to me. Just one nit.

@ZhiminXiang
Copy link

/lgtm
Thanks @samodell . It looks really good to me.

@knative-prow-robot knative-prow-robot added the lgtm Indicates that a PR is ready to be merged. label May 15, 2019
@knative-prow-robot knative-prow-robot merged commit cca04be into knative:master May 15, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes Indicates the PR's author has signed the CLA. lgtm Indicates that a PR is ready to be merged. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Istio install page

7 participants