knative
/
docs
mirror of https://github.com/knative/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Format markdown (#1600) 

* Format markdown

Produced via:
  `prettier --write --prose-wrap=always $(find -name '*.md' | grep -v vendor | grep -v .github)`
/assign @samodell

* Remove backticks

The indentation and backticks are redundant, so the backticks show up in the `<pre>` block.
This commit is contained in:
mattmoor-sockpuppet 2019-07-16 07:14:28 -07:00 committed by Knative Prow Robot
parent e850446660
commit 14cb5fb401
6 changed files with 95 additions and 96 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/install/Knative-custom-install.md
View File

@ -35,7 +35,8 @@ to run multiple installation commands.
## Installing Istio ## Installing Istio
> Note: [Ambassador](https://www.getambassador.io/) and [Gloo](https://gloo.solo.io/) are available as an alternative to Istio. > Note: [Ambassador](https://www.getambassador.io/) and
> [Gloo](https://gloo.solo.io/) are available as an alternative to Istio.
> [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador. > [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador.
> [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. > [Click here](./Knative-with-Gloo.md) to install Knative with Gloo.

3
docs/install/Knative-with-AKS.md
View File

@ -133,7 +133,8 @@ recommended configuration for a cluster is:
## Installing Istio ## Installing Istio
> Note: [Ambassador](https://www.getambassador.io/) and [Gloo](https://gloo.solo.io/) are available as an alternative to Istio. > Note: [Ambassador](https://www.getambassador.io/) and
> [Gloo](https://gloo.solo.io/) are available as an alternative to Istio.
> [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador. > [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador.
> [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. > [Click here](./Knative-with-Gloo.md) to install Knative with Gloo.

38
docs/install/Knative-with-Ambassador.md
View File

@ -6,8 +6,7 @@ type: "docs"
--- ---
[Ambassador](https://www.getambassador.io/) is a popular Kubernetes-native, [Ambassador](https://www.getambassador.io/) is a popular Kubernetes-native,
open-source API gateway built on open-source API gateway built on [Envoy Proxy](https://www.envoyproxy.io/).
[Envoy Proxy](https://www.envoyproxy.io/).
This guide walks you through the installation of the latest version of Knative This guide walks you through the installation of the latest version of Knative
using pre-built images. using pre-built images.
@ -26,11 +25,12 @@ This guide assumes that you have already
## Install Ambassador ## Install Ambassador
Knative was originally built using Istio to handle cluster networking. While Knative was originally built using Istio to handle cluster networking. While the
the Istio gateway provides the functionality needed to serve requests to your Istio gateway provides the functionality needed to serve requests to your
application, installing a service mesh to handle north-south traffic carries application, installing a service mesh to handle north-south traffic carries
some operational overhead with it. Ambassador provides a way to get traffic to some operational overhead with it. Ambassador provides a way to get traffic to
your Knative application without the overhead or complexity of a full service mesh. your Knative application without the overhead or complexity of a full service
mesh.
You can install Ambassador with `kubectl`: You can install Ambassador with `kubectl`:
@ -67,21 +67,19 @@ see Performing a Custom Knative Installation.
command once with the `-l knative.dev/crd-install=true` flag. This prevents command once with the `-l knative.dev/crd-install=true` flag. This prevents
race conditions during the install, which cause intermittent errors: race conditions during the install, which cause intermittent errors:
```
kubectl apply -l knative.dev/crd-install=true \ kubectl apply -l knative.dev/crd-install=true \
--filename https://github.com/knative/serving/releases/download/v0.7.1/serving.yaml \ --filename https://github.com/knative/serving/releases/download/v0.7.1/serving.yaml \
--filename https://github.com/knative/build/releases/download/v0.7.1/build.yaml \ --filename https://github.com/knative/build/releases/download/v0.7.1/build.yaml \
--filename https://github.com/knative/serving/releases/download/v0.7.1/monitoring.yaml --filename https://github.com/knative/serving/releases/download/v0.7.1/monitoring.yaml
```
2. To complete the install of Knative and it's dependencies, run the 2. To complete the install of Knative and it's dependencies, run the
`kubectl apply` command again, this time without the `kubectl apply` command again, this time without the
`-l knative.dev/crd-install=true`: `-l knative.dev/crd-install=true`:
```
kubectl apply --filename https://github.com/knative/serving/releases/download/v0.7.1 serving.yaml --selector networking.knative.dev/certificate-provider!=cert-manager \ kubectl apply --filename https://github.com/knative/serving/releases/download/v0.7.1 serving.yaml --selector networking.knative.dev/certificate-provider!=cert-manager \
--filename https://github.com/knative/build/releases/download/v0.7.1/build.yaml \ --filename https://github.com/knative/build/releases/download/v0.7.1/build.yaml \
--filename https://github.com/knative/serving/releases/download/v0.7.1/monitoring.yaml --filename https://github.com/knative/serving/releases/download/v0.7.1/monitoring.yaml
```
> **Notes**: > **Notes**:
> >
> - By default, the Knative Serving component installation (`serving.yaml`) > - By default, the Knative Serving component installation (`serving.yaml`)
@ -90,11 +88,11 @@ race conditions during the install, which cause intermittent errors:
> If you do intend on immediately enabling auto certificates in Knative, > If you do intend on immediately enabling auto certificates in Knative,
> you can remove the > you can remove the
> `--selector networking.knative.dev/certificate-provider!=cert-manager` > `--selector networking.knative.dev/certificate-provider!=cert-manager`
> statement to install the controller. Otherwise, you can choose to install > statement to install the controller. Otherwise, you can choose to
> the auto certificates feature and controller at a later time. > install the auto certificates feature and controller at a later time.
3. Monitor the Knative namespaces and wait until all of the pods come up with 3. Monitor the Knative namespaces and wait until all of the pods come up with a
a `STATUS` of `Running`: `STATUS` of `Running`:
``` ```
kubectl get pods -w --all-namespaces kubectl get pods -w --all-namespaces
@ -108,8 +106,8 @@ route traffic to a serverless application.
1. Create a `Knative Service` 1. Create a `Knative Service`
For this demo, a simple helloworld application written in go will be used. For this demo, a simple helloworld application written in go will be used.
Copy the YAML below to a file called `helloworld-go.yaml` and apply it Copy the YAML below to a file called `helloworld-go.yaml` and apply it with
with `kubectl` `kubectl`
```yaml ```yaml
apiVersion: serving.knative.dev/v1alpha1 apiVersion: serving.knative.dev/v1alpha1
@ -133,10 +131,10 @@ route traffic to a serverless application.
2. Send a request 2. Send a request
`Knative Service`s are exposed via a `Host` header assigned by Knative. `Knative Service`s are exposed via a `Host` header assigned by Knative. By
By default, Knative will assign the default, Knative will assign the `Host`:
`Host`: `{service-name}.{namespace}.example.com`. You can verify this by `{service-name}.{namespace}.example.com`. You can verify this by checking the
checking the `EXTERNAL-IP` of the `helloworld-go` service created above. `EXTERNAL-IP` of the `helloworld-go` service created above.
``` ```
$ kubectl get service helloworld-go $ kubectl get service helloworld-go
@ -165,5 +163,3 @@ manage and route to serverless applications!
for Knative serving. for Knative serving.
- Take a look at the rest of what - Take a look at the rest of what
[Knative has to offer](https://knative.dev/docs/index.html) [Knative has to offer](https://knative.dev/docs/index.html)

3
docs/install/Knative-with-Minikube.md
View File

@ -58,7 +58,8 @@ minikube start --memory=8192 --cpus=6 \
## Installing Istio ## Installing Istio
> Note: [Ambassador](https://www.getambassador.io/) and [Gloo](https://gloo.solo.io/) are available as an alternative to Istio. > Note: [Ambassador](https://www.getambassador.io/) and
> [Gloo](https://gloo.solo.io/) are available as an alternative to Istio.
> [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador. > [Click here](./Knative-with-Ambassador.md) to install Knative with Ambassador.
> [Click here](./Knative-with-Gloo.md) to install Knative with Gloo. > [Click here](./Knative-with-Gloo.md) to install Knative with Gloo.

6
docs/install/README.md
View File

@ -29,9 +29,9 @@ Currently, three options exist which provide this functionality:
## Installing Knative with Ambassador ## Installing Knative with Ambassador
[Installing with Ambassador](./Knative-with-Ambassador.md) gives us an [Installing with Ambassador](./Knative-with-Ambassador.md) gives us an
alternative to installing a service mesh for routing to applications alternative to installing a service mesh for routing to applications with the
with the Knative Serving component. Note that Istio is required for the Knative Serving component. Note that Istio is required for the Knative Eventing
Knative Eventing component. component.
## Installing Knative with Gloo ## Installing Knative with Gloo