[jira] [Created] (IGNITE-10051) Kubernetes documentation improvements

["Maxim Pudov (JIRA)" <ji...@apache.org>]

Maxim Pudov created IGNITE-10051:
------------------------------------

             Summary: Kubernetes documentation improvements
                 Key: IGNITE-10051
                 URL: https://issues.apache.org/jira/browse/IGNITE-10051
             Project: Ignite
          Issue Type: Task
          Components: documentation
    Affects Versions: 2.6
            Reporter: Maxim Pudov
             Fix For: 2.8
         Attachments: kube-dashboard-access.yaml, mongodb-deployment.yaml

I verified the deployment instructions of a kubernetes cluster with apache ignite and found some issues.

1. AWS deployment:

[https://apacheignite.readme.io/docs/amazon-web-services-eks-deployment]

miss print:
{quote}{{kubbectl get pods}}
{quote}
has to be: 
{quote}{{kubectl get pods}}
{quote}
2. Google Cloud deployment

[https://apacheignite.readme.io/docs/google-cloud-deployment]

Screenshots seem to be outdated

3. Microsoft Azure deployment

[https://apacheignite.readme.io/docs/microsoft-azure-deployment#section-access-to-your-kubernetes-cluster]

3.1 At first I had no access to Kubernetes dashboard having this error:
azure kubernetes dashboard namespaces is forbidden: User "system:serviceaccount:kube-system:kubernetes-dashboard" cannot list namespaces at the cluster scope

This problem was solved by adding this config:
{quote}kubectl create -f [^kube-dashboard-access.yaml]
{quote}
3.2 Screenshots seem to be outdated for azure too.

4. Stateless deployment:

[https://apacheignite.readme.io/docs/stateless-deployment]

4.1 At first we create example-cube-rbac.xml locally, but then we don't use it.

4.2 Instead the configuration file ignite-deployment.yaml ([https://apacheignite.readme.io/docs/stateless-deployment#section-ignite-pods-deployment]) points to the wrong external configuration file:
{quote}{{https://raw.githubusercontent.com/apache/ignite/master/modules/kubernetes/config/example-kube-persistence.xml}}
{quote}
I believe, it has to point to 
{quote}[{{https://raw.githubusercontent.com/apache/ignite/master/modules/kubernetes/config/example-kube-rback.xml}}|https://raw.githubusercontent.com/apache/ignite/master/modules/kubernetes/config/example-kube-rbac.xml]
{quote}
4.3 In the same configuration file ignite-deployment.yaml there is a row
{quote}{{serviceAccountName: ignite}}
{quote}
with Tab symbol, which has to be replaced with double Space.

5. Web console kubernetes installation.

[https://apacheignite-tools.readme.io/docs/kubernetes-installation]

5.1 mongodb-deployment.yaml doesn't work as is. I had to modified it (check the attachment [^mongodb-deployment.yaml])

5.2 web-console-deployment.yaml - default image values aren't specified for frontend and backend (apacheignite/web-console-frontend, apacheignite/web-console-backend)

5.3 web-agent-deployment.yaml - serviceAccountName: "ignite-cluster" is incorrect. I guess "ignite" is the right one.

5.4 No such docker image as apacheignite/web-agent:mytag3.

6. General suggestions for kubernetes cluster deployment on GCC, AWS, Azure.

6.1 Create cluster via AWS Console, not command line. It's easier to pick values from drop down lists, and we don't provide complete installation via command line anyway.

6.2 When we suggest to use our configuration files for setting up services and pods, it is worth mentioning that our configs contain region parameter (zones: eu-west-1a) and user has to modify it himself.

6.3 The link to download configuration files points to the master branch, which could cause problems in future. For AWS it's [https://github.com/apache/ignite/tree/master/modules/kubernetes/config/eks]

 



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)