mirror of https://github.com/fluxcd/flagger.git
				
				
				
			Document Istio requirements
This commit is contained in:
		
							parent
							
								
									7c166e2b40
								
							
						
					
					
						commit
						b435a03fab
					
				| 
						 | 
				
			
			@ -4,22 +4,22 @@ This guide walks you through setting up Flagger on a Kubernetes cluster.
 | 
			
		|||
 | 
			
		||||
### Prerequisites
 | 
			
		||||
 | 
			
		||||
Flagger requires a Kubernetes cluster v1.11 or newer with the 
 | 
			
		||||
MutatingAdmissionWebhook and ValidatingAdmissionWebhook admission controllers enabled. 
 | 
			
		||||
Flagger requires a Kubernetes cluster **v1.11** or newer with the following admission controllers enabled:
 | 
			
		||||
 | 
			
		||||
Flagger depends on Istio v1.0.3 or newer configured with the following components:
 | 
			
		||||
* MutatingAdmissionWebhook
 | 
			
		||||
* ValidatingAdmissionWebhook 
 | 
			
		||||
 | 
			
		||||
Flagger depends on [Istio](https://istio.io/docs/setup/kubernetes/quick-start/) **v1.0.3** or newer 
 | 
			
		||||
with traffic management, telemetry and Prometheus enabled. 
 | 
			
		||||
 | 
			
		||||
A minimal Istio installation should contain the following services:
 | 
			
		||||
 | 
			
		||||
* istio-citadel
 | 
			
		||||
* istio-ingressgateway
 | 
			
		||||
* istio-pilot
 | 
			
		||||
* istio-policy
 | 
			
		||||
* istio-ingressgateway
 | 
			
		||||
* istio-sidecar-injector
 | 
			
		||||
* istio-telemetry
 | 
			
		||||
* prometheus
 | 
			
		||||
 | 
			
		||||
To install and configure Istio you can follow the instructions on 
 | 
			
		||||
[istio.io](https://istio.io/docs/setup/kubernetes/quick-start/).
 | 
			
		||||
 | 
			
		||||
### Install Flagger
 | 
			
		||||
 | 
			
		||||
Add Flagger Helm repository:
 | 
			
		||||
| 
						 | 
				
			
			@ -36,6 +36,8 @@ helm upgrade -i flagger flagger/flagger \
 | 
			
		|||
--set metricsServer=http://prometheus.istio-system:9090
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
You can install Flagger in any namespace as long as it can talk to the Istio Prometheus service on port 9090.
 | 
			
		||||
 | 
			
		||||
Enable **Slack** notifications:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
| 
						 | 
				
			
			@ -69,9 +71,9 @@ Deploy Grafana in the _**istio-system**_ namespace:
 | 
			
		|||
```bash
 | 
			
		||||
helm upgrade -i flagger-grafana flagger/grafana \
 | 
			
		||||
--namespace=istio-system \
 | 
			
		||||
--set url=http://prometheus:9090 \
 | 
			
		||||
--set url=http://prometheus.istio-system:9090 \
 | 
			
		||||
--set user=admin \
 | 
			
		||||
--set password=admin
 | 
			
		||||
--set password=change-me
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Or use helm template command and apply the generated yaml with kubectl:
 | 
			
		||||
| 
						 | 
				
			
			@ -81,15 +83,16 @@ Or use helm template command and apply the generated yaml with kubectl:
 | 
			
		|||
helm template flagger/grafana \
 | 
			
		||||
--name flagger-grafana \
 | 
			
		||||
--namespace=istio-system \
 | 
			
		||||
--set url=http://prometheus.istio-system:9090 \
 | 
			
		||||
--set user=admin \
 | 
			
		||||
--set password=admin \
 | 
			
		||||
--set password=change-me \
 | 
			
		||||
> $HOME/flagger-grafana.yaml
 | 
			
		||||
 | 
			
		||||
# apply
 | 
			
		||||
kubectl apply -f $HOME/flagger-grafana.yaml
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
You access Grafana using port forwarding:
 | 
			
		||||
You can access Grafana using port forwarding:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
kubectl -n istio-system port-forward svc/flagger-grafana 3000:3000
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue