Merge pull request #11 from SignorMercurio/master

Docs improvement

Author: mfanjie

3.microservice.md

@@ -1,101 +1,140 @@
-# Understand Microsoft
-## microsoft demo, run nginx as webserver
-```
+# Understand Microservice
+
+## Microservice demo, run nginx as webserver
+
+```shell
 $ kubectl run --image=nginx nginx
 ```
-## show running pod
-```
+
+## Show running pod
+
+```shell
 $ kubectl get po --show-labels -owide -w
 ```
-## expose svc
-```
+
+## Expose svc
+
+```shell
 $ kubectl expose deploy nginx --selector run=nginx --port=80 --type=NodePort
 ```
-## check svc detail
-```
+
+## Check svc detail
+
+```shell
 $ kubectl get svc
 ```
-## check nodeip
-```
+
+## Check nodeip
+
+```shell
 $ minikube ssh
 $ ifconfig eth1
 ```
-## access service
-```
+
+## Access service
+
+```shell
 $ curl <nodeip>:<nodeport>
 ```
-## run envoy
-```
+
+## Run envoy
+
+```shell
 $ kubectl create configmap envoy-config --from-file=envoy.yaml
 $ kubectl create -f envoy-deploy.yaml
 $ kubectl expose deploy envoy --selector run=envoy --port=10000 --type=NodePort
 ```
-## access service
-```
+
+## Access service
+
+```shell
 $ curl <nodeip>:<nodeport>
 ```
-## scale up/down/failover
-```
+
+## Scale up/down/failover
+
+```shell
 $ kubectl scale deploy <deployment-name> --replicas=<n>
 ```
-# configmap
-```
+
+# ConfigMap
+
+```sh
 cat game.properties
 
 #configmap from file
 kubectl create configmap game-config --from-file=game.properties
 kubectl create configmap game-env-config --from-env-file=game.properties
 kubectl get configmap -oyaml game-config
 ```
-## configmap from literal
-```
+
+## ConfigMap from literal
+
+```sh
 kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=charm
 #downward api pod
 kubectl create -f downward-api-pod.yaml
 kubectl get po downward-api-pod
 kubectl logs -f downward-api-pod
 ```
-# volume
-```
+
+# Volume
+
+```sh
 kubectl create -f configmap-volume-pod.yaml
 kubectl get po
 kubectl logs -f configmap-volume-pod
 ```
-# readiness probe
-```
+
+# Readiness probe
+
+```sh
 kubectl create -f centos-readiness.yaml
 ```
-# multiple container pods
-## get object by columns
-```
+
+# Multiple container pods
+
+## Get object by columns
+
+```sh
 kubectl get svc  -o=custom-columns=NAME:.metadata.name,CREATED:'.metadata.annotations'
 ```
+
 # Operator
+
 ## kubebuilder
-```
+
+```shell
 $ kubebuilder init --domain example.com
 $ kubebuilder create api --group infra --version v1 --kind WebService
 $ make install
 ```
-## operator sdk
-## create new project
-```
+
+## Operator sdk
+
+## Create new project
+
+```sh
 operator-sdk new memorycache-operator
 ```
-## add types
 
-```
+## Add types
+
+```sh
 cd memorycache-operator
 operator-sdk add api --api-version=cache.example.com/v1alpha1 --kind=Memcached
 ```
-## modify types and generate new code
 
-```
+## Modify types and generate new code
+
+```sh
 operator-sdk generate k8s
 operator-sdk generate openapi
 ```
-## operator helm
-```
+
+## Operator helm
+
+```sh
 operator-sdk new nginx-operator --type=helm --kind=Nginx --api-version=web.example.com/v1alpha1
 operator-sdk add crd --api-version=web.example.com/v1alpha1 --kind=Envoy --update-watches=true
-```
+```

4.istio-setup.md

@@ -1,30 +1,45 @@
 # Setup Istio
+
 ## Download istio release
-```
+
+```shell
 $ curl -L https://istio.io/downloadIstio | sh -
 ```
+
 ## Move to the Istio package directory
-```
+
+```shell
 $ cd istio-1.6.2
 ```
+
 ## Add istioctl to path
-```
+
+```shell
 $ export PATH=$PWD/bin:$PATH
 ```
+
 ## Install Istio
-```
+
+```shell
 $ istioctl install --set profile=demo
 ```
+
 # Manage Istio
+
 ## Enable access log
-```
+
+```shell
 $ istioctl manifest apply --set values.global.proxy.accessLogFile="/dev/stdout"
 ```
+
 ## Enable mts
-```
+
+```shell
 $ istioctl manifest apply --set values.global.mtls.enabled=true --set values.global.controlPlaneSecurityEnabled=true
 ```
+
 ## Enable tracing
-```
+
+```shell
 $ istioctl manifest apply --set values.tracing.enabled=disable --set values.tracing.provider=zipkin
 ```

5.undestand-istio.md

@@ -1,43 +1,61 @@
 # Understand Istio
+
 ## Create bookinfo app sample
-```
+
+```shell
 $ kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml
 ```
 
-## create dr
-```
+## Create destination rule
+
+```shell
 $ kubectl apply -f samples/bookinfo/networking/destination-rule-all.yaml
 ```
+
 ## vs all v1
-```
+
+```shell
 $ kubectl apply -f samples/bookinfo/networking/virtual-service-all-v1.yaml
 ```
-## header based vs
-```
+
+## Header based vs
+
+```shell
 $ kubectl apply -f samples/bookinfo/networking/virtual-service-reviews-test-v2.yaml
 ```
-## delete vs
-```
+
+## Delete vs
+
+```shell
 $ kubectl delete -f samples/bookinfo/networking/virtual-service-all-v1.yaml
 ```
-## add fix delay to rating
-```
+
+## Add fix delay to rating
+
+```shell
 $ kubectl apply -f samples/bookinfo/networking/virtual-service-ratings-test-delay.yaml
 ```
+
 ## proxy-config
-```
+
+```shell
 $ istioctl pc
 ```
+
 ## proxy-status
-```
+
+```shell
 $ istioctl ps
 ```
-## check authn status
-```
+
+## Check authn status
+
+```shell
 $ istioctl authn tls-check details-v1-74f858558f-qqg99
 ```
-## rate limit
-```
+
+## Rate limit
+
+```shell
 $ kubectl apply -f samples/bookinfo/policy/mixer-rule-productpage-ratelimit.yaml
 ```
-

envoy_default.yaml

@@ -0,0 +1,55 @@
+admin:
+  access_log_path: /tmp/admin_access.log
+  address:
+    socket_address:
+      protocol: TCP
+      address: 0.0.0.0
+      port_value: 9901
+static_resources:
+  listeners:
+  - name: listener_0
+    address:
+      socket_address:
+        protocol: TCP
+        address: 0.0.0.0
+        port_value: 10000
+    filter_chains:
+    - filters:
+      - name: envoy.http_connection_manager
+        config:
+          access_log:
+          - name: envoy.file_access_log
+            config:
+              path: "/dev/stdout"
+        typed_config:
+          "@type": type.googleapis.com/envoy.config.filter.network.http_connection_manager.v2.HttpConnectionManager
+          stat_prefix: ingress_http
+          route_config:
+            name: local_route
+            virtual_hosts:
+            - name: local_service
+              domains: ["*"]
+              routes:
+              - match:
+                  prefix: "/nginx"
+                route:
+                  host_rewrite: www.google.com
+                  cluster: service_google
+          http_filters:
+          - name: envoy.router
+  clusters:
+  - name: service_google
+    connect_timeout: 0.25s
+    type: LOGICAL_DNS
+    # Comment out the following line to test on v6 networks
+    dns_lookup_family: V4_ONLY
+    lb_policy: ROUND_ROBIN
+    load_assignment:
+      cluster_name: service_google
+      endpoints:
+      - lb_endpoints:
+        - endpoint:
+            address:
+              socket_address:
+                address: nginx
+                port_value: 80