Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add default cluster template to magnum kubernetes cluster setup guide
Browse files Browse the repository at this point in the history
sowm9802 committed Jan 21, 2025
1 parent af26a26 commit f4db43f
Showing 2 changed files with 32 additions and 2 deletions.
22 changes: 21 additions & 1 deletion docs/magnum-kubernetes-cluster-setup-guide.md
Original file line number Diff line number Diff line change
@@ -34,6 +34,26 @@ openstack keypair create mykey > mykey.pem

A ClusterTemplate is a collection of parameters to describe how a cluster can be constructed. Some parameters are relevant to the infrastructure of the cluster, while others are for the particular COE. In a typical workflow, a user would create a ClusterTemplate, then create one or more clusters using the ClusterTemplate. A ClusterTemplate cannot be updated or deleted if a cluster using this ClusterTemplate still exists.

!!! note "Information about the Default Public ClusterTemplate"

A default ClusterTemplate, named default-cluster-template, can be created in the environment and used by anyone to deploy new Kubernetes clusters. To use this template, pass the --cluster-template default-cluster-template parameter during cluster creation.

??? example "Default Public ClusterTemplate Creation"

``` shell
openstack coe cluster template create default-cluster-template \
--image magnum-fedora-coreos-40 \
--external-network PUBLICNET \
--dns-nameserver 8.8.8.8 \
--master-flavor gp.0.4.8 \
--flavor gp.0.4.8 \
--network-driver calico \
--volume-driver cinder \
--docker-volume-size 10 \
--coe kubernetes \
--public
```

### Create a ClusterTemplate

Create a Kubernetes cluster template using the `magnum-fedora-coreos-40` image with the following configuration: `m1.large` flavor for both master and nodes, `public` as the external network, `8.8.8.8` for the DNS nameserver, `calico` for the network driver, and `cinder` for the volume driver. Below is the example command to create the clustertemplate. For more detailed information about the parameters and labels used in the ClusterTemplate, please refer to the [ClusterTemplate](https://docs.openstack.org/magnum/latest/user/index.html#clustertemplate).
@@ -47,7 +67,7 @@ openstack coe cluster template create new-cluster-template \
--flavor m1.large \
--network-driver calico \
--volume-driver cinder \
--docker-volume-size 3 \
--docker-volume-size 10 \
--coe kubernetes
```

12 changes: 11 additions & 1 deletion docs/openstack-magnum.md
Original file line number Diff line number Diff line change
@@ -8,7 +8,7 @@ OpenStack Magnum is the container orchestration service within the OpenStack eco

## Create secrets

!!! note "Information about the secretes used"
!!! note "Information about the secrets used"

Manual secret generation is only required if you haven't run the `create-secrets.sh` script located in `/opt/genestack/bin`.

@@ -42,3 +42,13 @@ OpenStack Magnum is the container orchestration service within the OpenStack eco

You may need to provide custom values to configure your openstack services, for a simple single region or lab deployment you can supply an additional overrides flag using the example found at `base-helm-configs/aio-example-openstack-overrides.yaml`.
In other cases such as a multi-region deployment you may want to view the [Multi-Region Support](multi-region-support.md) guide to for a workflow solution.

## Validate functionality

``` shell
kubectl --namespace openstack exec -ti openstack-admin-client -- openstack coe cluster list
```

## Create a Default Public ClusterTemplate

User must have the admin role to create the public ClusterTemplate. For instructions on creating the default public ClusterTemplate and using it to deploy a new Kubernetes cluster, please refer to the ClusterTemplate section in the [Magnum Kubernetes Cluster Setup Guide](https://docs.rackspacecloud.com/magnum-kubernetes-cluster-setup-guide/#clustertemplate).

0 comments on commit f4db43f

Please sign in to comment.