TOSCA/kubernetes-cluster-TOSCA/README.md

   1 [![Build Status](https://circleci.com/gh/cloudify-examples/simple-kubernetes-blueprint.svg?style=shield&circle-token=:circle-token)](https://circleci.com/gh/cloudify-examples/simple-kubernetes-blueprint)
   2
   3
   4 ##  Kubernetes Cluster Example
   5
   6 This blueprint creates an example Kubernetes cluster. It is intended as an example. The underlying Kubernetes configuration method used is [Kubeadm](https://kubernetes.io/docs/admin/kubeadm/), which is not considered production-ready.
   7
   8 Regardless of your infrastructure choice, this blueprint installs and configures on each VM:
   9 - The Kubernetes Yum repo will be installed on your VMs.
  10 - Docker, version 1.12.6-28.git1398f24.el7.centos
  11 - kubelet, version 1.8.6-0.
  12 - kubeadm, version 1.8.6-0.
  13 - kubernetes-cni, version 0.5.1-1.
  14 - weave
  15
  16
  17 ## prerequisites
  18
  19 You will need a *Cloudify Manager* running in either AWS, Azure, or Openstack. The Cloudify manager should be setup using the [Cloudify environment setup](https://github.com/cloudify-examples/cloudify-environment-setup) - that's how we test this blueprint. The following are therefore assumed:
  20 * You have uploaded all of the required plugins to your manager in order to use this blueprint. (See the imports section of the blueprint.yaml file to check that you are using the correct plugins and their respective versions.)
  21 * You have created all of the required secrets on your manager in order to use this blueprint. (See #secrets.)
  22 * A Centos 7.X image. If you are running in AWS or Openstack, your image must support [Cloud-init](https://cloudinit.readthedocs.io/en/latest/).
  23
  24
  25 #### Secrets
  26
  27 * Common Secrets:
  28   * agent_key_private
  29   * agent_key_public
  30
  31 * Openstack Secrets:
  32   * external_network_name: This is the network on your Openstack that represents the internet gateway network.
  33   * public_network_name: An openstack network. (Inbound is expected, outbound is required.)
  34   * public_subnet_name: A subnet on the public network.
  35   * private_network_name: An openstack network. (Inbound is not expected, outbound is required.)
  36   * private_subnet_name: A subnet on the network. (Inbound is not expected, outbound is required.)
  37   * router_name: This is a router that is attached to your Subnets designated in the secrets public_subnet_name and private_subnet_name.
  38   * region: Your Keystone V2 region.
  39   * keystone_url: Your Keystone V2 auth URL.
  40   * keystone_tenant_name: Your Keystone V2 tenant name.
  41   * keystone_password: Your Keystone V2 password.
  42   * keystone_username:Your Keystone V2 username.
  43
  44
  45 ### Step 1: Install the Kubernetes cluster
  46
  47 #### For Openstack run:
  48
  49 Please follow the instruction on wiki
  50 https://wiki.onap.org/display/DW/ONAP+on+Kubernetes+on+Cloudify#ONAPonKubernetesonCloudify-OpenStack
  51
  52
  53 ### Step 2: Verify the demo installed and started.
  54
  55 Once the workflow execution is complete, verify that these secrets were created:
  56
  57
  58 ```shell
  59 (Incubator)UNICORN:Projects trammell$ cfy secrets list
  60 Listing all secrets...
  61
  62 Secrets:
  63 +------------------------------------------+--------------------------+--------------------------+------------+----------------+------------+
  64 |                   key                    |        created_at        |        updated_at        | permission |  tenant_name   | created_by |
  65 +------------------------------------------+--------------------------+--------------------------+------------+----------------+------------+
  66 | kubernetes-admin_client_certificate_data | 2017-08-09 14:58:06.421  | 2017-08-09 14:58:06.421  |            | default_tenant |   admin    |
  67 |     kubernetes-admin_client_key_data     | 2017-08-09 14:58:06.513  | 2017-08-09 14:58:06.513  |            | default_tenant |   admin    |
  68 |  kubernetes_certificate_authority_data   | 2017-08-09 14:58:06.327  | 2017-08-09 14:58:06.327  |            | default_tenant |   admin    |
  69 |           kubernetes_master_ip           | 2017-08-09 14:56:12.359  | 2017-08-09 14:56:12.359  |            | default_tenant |   admin    |
  70 |          kubernetes_master_port          | 2017-08-09 14:56:12.452  | 2017-08-09 14:56:12.452  |            | default_tenant |   admin    |
  71 +------------------------------------------+--------------------------+--------------------------+------------+----------------+------------+
  72 ```
  73