mirror of https://github.com/istio/istio.io.git
Update prep & install docs for IBM (#4386)
This commit is contained in:
Rachael Graham
Martin Taillefer
parent
73c4478315
commit
476df4824f
Binary file not shown.
|
After Width: | Height: | Size: 223 KiB |
|
|
@ -11,18 +11,68 @@ aliases:
|
|||
Follow this flow to install and configure an Istio mesh in IBM Cloud.
|
||||
|
||||
You can use the [managed Istio add-on for IBM Cloud Kubernetes Service](#managed-istio-add-on)
|
||||
in IBM Cloud Public, use Helm to install Istio in [IBM Cloud Public](#ibm-cloud-public),
|
||||
in IBM Cloud Public, [install Istio manually](#manual-istio-install) in IBM Cloud Public,
|
||||
or install Istio in [IBM Cloud Private](#ibm-cloud-private).
|
||||
|
||||
## Managed Istio add-on
|
||||
|
||||
Istio on IBM Cloud Kubernetes Service provides a seamless installation of Istio, automatic updates and lifecycle management of Istio control plane components, and integration with platform logging and monitoring tools. With one click, you can get all Istio core components, additional tracing, monitoring, and visualization, and the Bookinfo sample app up and running. Istio on IBM Cloud Kubernetes Service is offered as a managed add-on, so IBM Cloud automatically keeps all your Istio components up to date.
|
||||
|
||||
To install the managed Istio add-on in IBM Cloud Public, see the [IBM Cloud Kubernetes Service documentation](https://cloud.ibm.com/docs/containers?topic=containers-istio).
|
||||
|
||||
## IBM Cloud Public
|
||||
|
||||
Follow [these instructions](/docs/setup/kubernetes/install/helm/) to install and run the current release version of Istio in [IBM Cloud Public](https://www.ibm.com/cloud/) using Helm and the IBM Cloud Kubernetes Service (IKS).
|
||||
### Managed Istio add-on
|
||||
|
||||
[Istio on IBM Cloud Kubernetes Service](https://cloud.ibm.com/docs/containers?topic=containers-istio) provides a seamless installation of Istio, automatic updates and lifecycle management of Istio control plane components, and integration with platform logging and monitoring tools. With one click, you can get all Istio core components, additional tracing, monitoring, and visualization, and the Bookinfo sample app up and running. Istio on IBM Cloud Kubernetes Service is offered as a managed add-on, so IBM Cloud automatically keeps all your Istio components up to date.
|
||||
|
||||
To install the managed Istio add-on in IBM Cloud Public, you can use the UI or the CLI.
|
||||
|
||||
**To use the UI**:
|
||||
|
||||
1. In your [cluster dashboard](https://cloud.ibm.com/kubernetes/clusters), click the name of a cluster.
|
||||
|
||||
1. Click the **Add-ons** tab.
|
||||
|
||||
1. On the Istio card, click **Install**. The Istio check box is already selected. To also install the Istio extras and BookInfo sample app, select the Istio Extras and the Istio Sample check boxes.
|
||||
|
||||
{{< image link="./add-on-install.png" caption="Enable managed Istio add-ons in the IBM Cloud console" >}}
|
||||
|
||||
1. Click Install. On the Istio card, verify that the add-ons you enabled are listed.
|
||||
|
||||
**To use the CLI**:
|
||||
|
||||
1. Install the `istio`, `istio-extras`, and `istio-sample-bookinfo` add-ons.
|
||||
|
||||
{{< text bash >}}
|
||||
$ ibmcloud ks cluster-addon-enable istio --cluster <cluster_name_or_ID>
|
||||
{{< /text >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ ibmcloud ks cluster-addon-enable istio-extras --cluster <cluster_name_or_ID>
|
||||
{{< /text >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ ibmcloud ks cluster-addon-enable istio-sample-bookinfo --cluster <cluster_name_or_ID>
|
||||
{{< /text >}}
|
||||
|
||||
1. Verify that the Istio services are deployed and their corresponding pods have a `STATUS` of `Running`.
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get svc -n istio-system
|
||||
{{< /text >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get pods -n istio-system
|
||||
{{< /text >}}
|
||||
|
||||
1. Verify that the BookInfo microservices are deployed and their corresponding pods have a `STATUS` of `Running`.
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get svc -n default
|
||||
{{< /text >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl get pods -n default
|
||||
{{< /text >}}
|
||||
|
||||
### Manual Istio install
|
||||
|
||||
Follow [these instructions](/docs/setup/kubernetes/) to install and run the current release version of Istio in [IBM Cloud Public](https://www.ibm.com/cloud/) using the IBM Cloud Kubernetes Service (IKS).
|
||||
|
||||
To upgrade Istio in an existing IKS cluster, follow the [upgrade instructions](/docs/setup/kubernetes/upgrade) instead.
|
||||
|
||||
|
|
|
|||
|
|
@ -8,15 +8,7 @@ aliases:
|
|||
keywords: [platform-setup,ibm,iks]
|
||||
---
|
||||
|
||||
Follow these instructions to prepare an IBM Cloud cluster for Istio.
|
||||
|
||||
You can use the [Managed Istio add-on for IBM Cloud Kubernetes Service](#managed-istio-add-on) in IBM Cloud Public, use Helm to install Istio in [IBM Cloud Public](#ibm-cloud-public), or install Istio in [IBM Cloud Private](#ibm-cloud-private).
|
||||
|
||||
## Managed Istio add-on
|
||||
|
||||
Istio on IBM Cloud Kubernetes Service provides a seamless installation of Istio, automatic updates and lifecycle management of Istio control plane components, and integration with platform logging and monitoring tools. With one click, you can get all Istio core components, additional tracing, monitoring, and visualization, and the Bookinfo sample app up and running. Istio on IBM Cloud Kubernetes Service is offered as a managed add-on, so IBM Cloud automatically keeps all your Istio components up to date.
|
||||
|
||||
To install the managed Istio add-on in IBM Cloud Public, see the [IBM Cloud Kubernetes Service documentation](https://cloud.ibm.com/docs/containers/cs_istio.html).
|
||||
Follow these instructions to prepare an IBM Cloud cluster for Istio. You can install Istio in [IBM Cloud Public](#ibm-cloud-public) or [IBM Cloud Private](#ibm-cloud-private).
|
||||
|
||||
## IBM Cloud Public
|
||||
|
||||
|
|
@ -25,16 +17,16 @@ To install the managed Istio add-on in IBM Cloud Public, see the [IBM Cloud Kube
|
|||
1. Create a standard Kubernetes cluster. Replace `<cluster-name>` with the name of the cluster you want to use in the following instructions.
|
||||
|
||||
{{< tip >}}
|
||||
To see available zones, run `ibmcloud ks zones`. Zones are isolated from each other, which ensures no shared single point of failure. IBM Cloud Kubernetes Service [Regions and zones](https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones) describes regions, zones, and how to specify the region and zone for your new cluster.
|
||||
To see available zones, run `ibmcloud ks zones`. Zones are isolated from each other, which ensures no shared single point of failure. IBM Cloud Kubernetes Service [Locations](https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones) describes available zones and how to specify the zone for your new cluster.
|
||||
{{< /tip >}}
|
||||
|
||||
{{< tip >}}
|
||||
The command below does not contain the `--private-vlan value` and `--public-vlan value` options. To see available VLANs, run `ibmcloud ks vlan-ls --zone <zone-name>`. If you do not have a private and public VLAN yet, they will be automatically created for you. If you already have VLANs, they need to be specified using the `--private-vlan value` and `--public-vlan value` options.
|
||||
The command below does not contain the `--private-vlan value` and `--public-vlan value` options. To see available VLANs, run `ibmcloud ks vlans --zone <zone-name>`. If you do not have a private and public VLAN yet, they will be automatically created for you. If you already have VLANs, specify them by using the `--private-vlan value` and `--public-vlan value` options.
|
||||
{{< /tip >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ ibmcloud ks cluster-create --zone <zone-name> --machine-type b2c.4x16 \
|
||||
--name <cluster-name>
|
||||
$ ibmcloud ks cluster-create --zone <zone-name> --machine-type b3c.4x16 \
|
||||
--workers 3 --name <cluster-name>
|
||||
{{< /text >}}
|
||||
|
||||
1. Retrieve your credentials for `kubectl`.
|
||||
|
|
@ -43,9 +35,9 @@ To install the managed Istio add-on in IBM Cloud Public, see the [IBM Cloud Kube
|
|||
$(ibmcloud ks cluster-config <cluster-name> --export)
|
||||
{{< /text >}}
|
||||
|
||||
{{< warning >}}
|
||||
Make sure to use the `kubectl` CLI version that matches the Kubernetes version of your cluster.
|
||||
{{< /warning >}}
|
||||
{{< warning >}}
|
||||
Make sure to use the `kubectl` CLI version that matches the Kubernetes version of your cluster.
|
||||
{{< /warning >}}
|
||||
|
||||
## IBM Cloud Private
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue