Skip to content

Commit

Permalink
Add default cluster template to magnum kubernetes cluster setup guide
Browse files Browse the repository at this point in the history
  • Loading branch information
sowm9802 committed Jan 21, 2025
1 parent af26a26 commit d926a3b
Show file tree
Hide file tree
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
Expand Up @@ -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, should be created in the environment and can be used to deploy new Kubernetes clusters. To use the default template, pass the --cluster-template default-cluster-template parameter during cluster creation.

??? example "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).
Expand All @@ -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
```

Expand Down
12 changes: 11 additions & 1 deletion docs/openstack-magnum.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

Expand Down Expand Up @@ -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 for Kubernetes cluster creation, please refer to the ClusterTemplate section of the [Magnum Kubernetes Cluster Setup Guide](https://docs.rackspacecloud.com/magnum-kubernetes-cluster-setup-guide/#create-a-clustertemplate).

0 comments on commit d926a3b

Please sign in to comment.