Merge 2.4 into 2.5

Author: soyuka

deployment/kubernetes.md

@@ -18,7 +18,7 @@ package manager) chart to deploy in a wink on any of these platforms.
 
 1. Build the PHP and NGINX Docker images:
 
-```
+```console
 docker build -t gcr.io/test-api-platform/php -t gcr.io/test-api-platform/php:latest api --target api_platform_php
 docker build -t gcr.io/test-api-platform/nginx -t gcr.io/test-api-platform/nginx:latest api --target api_platform_nginx
 docker build -t gcr.io/test-api-platform/varnish -t gcr.io/test-api-platform/varnish:latest api --target api_platform_varnish
@@ -28,15 +28,15 @@ docker build -t gcr.io/test-api-platform/varnish -t gcr.io/test-api-platform/var
 
 Docker client versions <= 18.03:
 
-```
+```console
 gcloud docker -- push gcr.io/test-api-platform/php
 gcloud docker -- push gcr.io/test-api-platform/nginx
 gcloud docker -- push gcr.io/test-api-platform/varnish
 ```
 
 Docker client versions > 18.03:
 
-```
+```console
 gcloud auth configure-docker
 docker push gcr.io/test-api-platform/php
 docker push gcr.io/test-api-platform/nginx
@@ -47,42 +47,42 @@ docker push gcr.io/test-api-platform/varnish
 
 Firstly you need to update helm dependencies by running:
 
-```
-    helm dependency update ./api/helm/api
+```console
+helm dependency update ./api/helm/api
 ```
 
 You are now ready to deploy the API!
 
 Deploy your API to the container:
 
-```
-    helm install ./api/helm/api --namespace=baz --name baz \
-        --set php.repository=gcr.io/test-api-platform/php \
-        --set nginx.repository=gcr.io/test-api-platform/nginx \
-        --set secret=MyAppSecretKey \
-        --set postgresql.postgresPassword=MyPgPassword \
-        --set postgresql.persistence.enabled=true \
-        --set corsAllowOrigin='^https?://[a-z\]*\.mywebsite.com$'
+```console
+helm install ./api/helm/api --namespace=baz --name baz \
+    --set php.repository=gcr.io/test-api-platform/php \
+    --set nginx.repository=gcr.io/test-api-platform/nginx \
+    --set secret=MyAppSecretKey \
+    --set postgresql.postgresPassword=MyPgPassword \
+    --set postgresql.persistence.enabled=true \
+    --set corsAllowOrigin='^https?://[a-z\]*\.mywebsite.com$'
 ```
 
 If you prefer to use a managed DBMS like [Heroku Postgres](https://www.heroku.com/postgres) or
 [Google Cloud SQL](https://cloud.google.com/sql/docs/postgres/) (recommended):
 
-```
-    helm install --name api ./api/helm/api \
-        # ...
-        --set postgresql.enabled=false \
-        --set postgresql.url=pgsql://username:password@host/database?serverVersion=9.6
+```console
+helm install --name api ./api/helm/api \
+    # ...
+    --set postgresql.enabled=false \
+    --set postgresql.url=pgsql://username:password@host/database?serverVersion=9.6
 ```
 
 If you want to use a managed Varnish such as [Fastly](https://www.fastly.com) for the invalidation cache mechanism
 provided by API Platform:
 
-```
-    helm install --name api ./api/helm/api \
-        # ...
-        --set varnish.enabled=false \
-        --set varnish.url=https://myvarnish.com
+```console
+helm install --name api ./api/helm/api \
+    # ...
+    --set varnish.enabled=false \
+    --set varnish.url=https://myvarnish.com
 ```
 
 Finally, build the `client` and `admin` JavaScript apps and [deploy them on a static
@@ -92,6 +92,9 @@ website hosting service](https://create-react-app.dev/docs/deployment/).
 
 Before running your application for the first time, be sure to create the database schema:
 
+```console
+PHP_POD=$(kubectl --namespace=bar get pods -l app=php -o jsonpath="{.items[0].metadata.name}")
+kubectl --namespace=bar exec -it $PHP_POD -- bin/console doctrine:schema:create
 ```
     PHP_POD=$(kubectl --namespace=bar get pods -l app=php -o jsonpath="{.items[0].metadata.name}")
     kubectl --namespace=bar exec -it $PHP_POD -- bin/console doctrine:schema:create
@@ -101,7 +104,7 @@ Before running your application for the first time, be sure to create the databa
 
 We noticed that some tiller RBAC trouble occurred. You can usually resolve it by running:
 
-```
+```console
 kubectl create serviceaccount --namespace kube-system tiller
   serviceaccount "tiller" created