Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

VMware VIO supports Container Orchestration. Container Orchestration can be used a product or as a service.

...

  1. Go to your web browser (Firefox/Chrome Recommended).

  2. Visit https://FQDN/login or https://VIO_K8s_IP_Address/login
    Image Removed
    Image Added

Step 2: Create a Cloud Provider

  1. Go to Cloud Provider and click on Deploy New Provider.
    Image Removed
    Image Added

  2. If you have a JSON File with all the configurations, then click on Choose File and upload the JSON.
    Otherwise, click Next.
    Image Removed
    Image Added

  3. Give a Provider name and select OpenStack as the Provider type, then click Next.
    Image Removed
    Image Added

  4. We need to provide OpenStack Authentication now to add it as the Cloud Provider. 
    Give the Keystone Public URL, Username, Password, Project name, Region name, Domain name and upload the CA Certificate.
    (CA Certificate is an important step for successful OpenStack Authentication, you can found more details about the certificate on the Page 34 of this PDF.)
    Click Next.
    Image Removed
    Image Added

  5. Now, we need to select the Image which will be used to deploy the Kubernetes Master and Worker Nodes.
    We are selecting Ubuntu 16.04 as the image for our deployment.
    Give the Image username and Select an image from the list. 
    (This list will be fetched from your VMware Integrated Openstack deployment post successful authentication.)
    Image Removed
    Image Added

  6. Now, we need to select the Flavor which will be used to deploy the Kubernetes Master and Worker Nodes.
    We are selecting m1.oom as the flavor for our deployment. This is a custom flavor created on VMware Integrated OpenStack 4.1.
    (It is recommended to create a flavor which meets the minimum hardware configurations as described above in this document.)
    Select a flavor from the list. (This list will be fetched from your VMware Integrated Openstack deployment post successful authentication.)
    Click Next.
    Image Removed
    Image Added

  7. If you are not using NSX-T, then you can click Next.
    If you are using NSX-T, then give then Manager address, Username, Password, Tier 0 Router and Transport zone.
    Image RemovedImage Removed
    Image AddedImage Added
  8. Now, we need to select the Security Group which will be applied to all the cluster nodes. All the security groups created by you will be listed here.
    Select security group(s) has a list of groups with their names, select them as per your requirements.
    Click Next.
    Image Removed
    Image Added
  9. Now, we need to select the External Network which will used to expose Kubernetes Cluster API and also for external services. All the external networks created by you will be listed here.
    Select external network has a list of external network with their names, select the external network as per your requirement.
    (Please make sure that at least two floating IPs are available.)
    Click Next.
    Image Removed
    Image Added
  10. Now, we need to select the Internal Network, it should be connected to the External Network via a router and should have atleast one subnet. All the internal networks created by you will be listed here.
    Select internal network and Select a subnet has a list of internal networks and subnets with their names, select the internal network and subnet as per your requirement.
    Click Next.
    Image Removed
    Image Added
  11. Now, check the Configuration Summary and verify the information.
    If you wish to download the JSON of your configurations, click on Download Provider JSON.
    Click Finish to add the Cloud Provider.
    Image Removed
    Image Added

  12. The addition of Cloud Provider is pretty quick and it should be added instantly as soon you click Finish. If not then kindly wait for few minutes.

  13. You can check your Cloud Provider on the page.
    It should show the state as ACTIVE, denoting successful addition of Cloud Provider.
    Image RemovedImage Removed
    Image AddedImage Added


  14. You can get additional information regarding a Cloud Provider by clicking on it's name.
    Image Removed
    Image Added

Step 3: Create a Kubernetes Cluster

  1. Go to Clusters and click on Deploy New Cluster.
    Image Removed
    Image Added


  2. If you have a JSON File with all the configurations, then click on Choose File and upload the JSON.
    Otherwise, click Next.
    Image Removed
    Image Added


  3. Select an Infrastructure Provider, it shows a list of all the Cloud Providers you have added.
    Select the one on which you want to deploy your Kubernetes Cluster. 
    Click Next.

    Image RemovedImage Added


  4. Select an Infrastructure Node Profile, it is the configuration using which your Kubernetes Cluster will be deployed.
    If you want to use the default profile, click on the checkbox of Use default node profile.
    (You can also add your own profiles from the Cloud Provider section and then select the one on which you want to deploy your Kubernetes Cluster from the list.)
    Click Next.


    Image Removed Image RemovedImage AddedImage Added



  5. Now, we need to add Cluster Data.
    Give the Cluster Name, Number of Master Nodes, Number of Worker Nodes, DNS Servers and Cluster Type (Shared or Exclusive).
    (In an exclusive cluster, multi-tenancy is not supported. In a shared cluster, multi-tenancy is supported and enforced by the Kubernetes namespace.)
    Click Next.
    Image Removed
    Image Added


  6. Now, we need to add Users & Groups for this cluster.
    Select the Users and Group from the list, or we can provide additional users and groups if they are not created.
    Click Next.

    Image Removed
    Image Added


  7. Now, check the Kubernetes Cluster Deployment Summary and verify the information.
    If you wish to download the JSON of your configurations, click on Download Cluster JSON.
    Click Finish to start the deployment of Kubernetes Cluster.

    Image Removed
    Image Added



  8. The deployment of Kubernetes Cluster takes some time as compared to Cloud Provider.
    Please be patient while the Cluster is being deployed. Once deployed, the state of cluster will change from CREATING to READY.
    Image Removed
    Image Added

    During the deployment process, the cluster state will be CREATING.

    Image RemovedImage Added

    After the successful deployment process, the cluster state will be ACTIVE.

    Image RemovedImage Added

    During the deployment process if there is an error, the cluster state will be changed to ERROR.
    Image Removed
    Image Added

    Meanwhile, you can login to your VMware Integrated OpenStack Horizon and check if the correct number of instance have been deployed or not. If they are there then the deployment is in progress,
    if you don't see these instance after 5 mins then there is a possiblity that the deployment has faced some error.
    Image Removed

    Image Added

    If you want to delete your cluster, the cluster state will be changed to DELETING.
    Image RemovedImage Removed
    Image AddedImage Added

Step 4: Login to Kubernetes Master and Worker Nodes

  1. SSH into the VMware Integrated OpenStack with Kubernetes.

    Image RemovedImage Added

  2. Once you are logged into VMware Integrated OpenStack with Kubernetes, use the following command with the same username and password used during SSH:

    Code Block
    themeMidnight
    #vkube  login --insecure

    Image RemovedImage Added


  3. Get the list of all the clusters along with their Cluster ID, use the following command:

    Code Block
    themeMidnight
    #vkube cluster list --insecure

    Make a note of the Cluster ID of the cluster you want to access or know more about.

    Image RemovedImage Added 

  4. Get the detailed information about the nodes running on a particular cluster, use the following command:

    Code Block
    themeMidnight
    #vkube cluster show <Cluster ID> --insecure 

    Make a note of the IP of the Master and Worker Nodes.

    Image RemovedImage Added

  5. Get a list of all the docker containers running in background.

    Code Block
    themeMidnight
    #docker ps -a

    Image RemovedImage Added


  6. Get an interactive shell of the docker conatiner with the name app-api.

    Code Block
    themeMidnight
    #docker exec -it <Container ID or Name> /bin/bash 

    After this command, you'll get a shell of a running container.

    Image Removed Image Added 

  7. Once we are inside a running container, change the directory and go the cluster location using the following command:

    Code Block
    themeMidnight
    #cd /var/lib/vrc/terraform/<ClusterID>

    Image RemovedImage Added


  8. Once you are into the correct directory, use the following command to SSH into the Kubernetes Master or Worker Node depending on the IP Address:

    Code Block
    themeMidnight
    #ssh -i private.key -F ssh-bastion.conf ubuntu@Kubernetes_Host_IP_Address

    Image RemovedImage Added

  9. Once you are inside the Kubernetes Nodes, you can deploy ONAP, or troubleshoot an error as per your requirements.

...

  1. Go to Clusters and click on Deploy New Cluster.

  2. If you have a JSON File with all the configurations, then click on Choose File and upload the JSON.
    Otherwise, click Next.

  3. Select an Infrastructure Provider, it shows a list of all the Cloud Providers you have added.
    Select the one on which you want to deploy your Kubernetes Cluster. 
    Click Next.

  4. Select an Infrastructure Node Profile, it is the configuration using which your Kubernetes Cluster will be deployed.
    If you want to use the default profile, click on the checkbox of Use default node profile.
    (You can also add your own profiles from the Cloud Provider section and then select the one on which you want to deploy your Kubernetes Cluster from the list.)
    Click Next.


  5. Now, we need to add Cluster Data.
    Give the Cluster Name, Number of Master Nodes, Number of Worker Nodes, DNS Servers and Cluster Type (Shared or Exclusive).
    (In an exclusive cluster, multi-tenancy is not supported. In a shared cluster, multi-tenancy is supported and enforced by the Kubernetes namespace.)
    Click Next.


  6. Now, we need to add Users & Groups for this cluster.
    Select the Users and Group from the list, or we can provide additional users and groups if they are not created.
    Click Next.


  7. Now, check the Kubernetes Cluster Deployment Summary and verify the information.
    If you wish to download the JSON of your configurations, click on Download Cluster JSON.
    Click Finish to start the deployment of Kubernetes Cluster.


  8. The deployment of Kubernetes Cluster takes some time as compared to Cloud Provider.
    Please be patient while the Cluster is being deployed. Once deployed, the state of cluster will change from CREATING to READY.

    During the deployment process, the cluster state will be CREATING.
    After the successful deployment process, the cluster state will be ACTIVE.

  9. During the deployment process if there is an error, the cluster state will be changed to ERROR.

  10. Meanwhile, you can login to your VMware Integrated OpenStack Horizon and check if the correct number of instance have been deployed or not. If they are there then the deployment is in progress, if you don't see these instance after 5 mins then there is a possiblity that the deployment has faced some error.
    If you want to delete your cluster, the cluster state will be changed to DELETING.
     

...