Quickstart for Ansible-based Operators

A simple set of instructions that demonstrates the basics of setting up and running a Ansible-based operator.

This guide walks through an example of building a simple memcached-operator powered by Ansible using tools and libraries provided by the Operator SDK.

Prerequisites

  • Install operator-sdk and the [Ansible prequisites][ansible-operator-install]
  • Access to a Kubernetes v1.16.0+ cluster.
  • User authorized with cluster-admin permissions.

Quickstart Steps

Create a project

Create and change into a directory for your project. Then call operator-sdk init with the Ansible plugin to initialize the base project layout:

  1. mkdir memcached-operator
  2. cd memcached-operator
  3. operator-sdk init --plugins=ansible --domain=example.com

Create an API

Let’s create a new API with a role for it:

  1. operator-sdk create api --group cache --version v1 --kind Memcached --generate-role

Build and push the operator image

Use the built-in Makefile targets to build and push your operator. Make sure to define IMG when you call make:

  1. make docker-build docker-push IMG=<some-registry>/<project-name>:<tag>

NOTE: To allow the cluster pull the image the repository needs to be set as public or you must configure an image pull secret.

Run the operator

Install the CRD and deploy the project to the cluster. Set IMG with make deploy to use the image you just pushed:

  1. make install
  2. make deploy IMG=<some-registry>/<project-name>:<tag>

Create a sample custom resource

Create a sample CR:

  1. kubectl apply -f config/samples/cache_v1_memcached.yaml

Watch for the CR be reconciled by the operator:

  1. kubectl logs deployment.apps/memcached-operator-controller-manager -n memcached-operator-system -c manager

Clean up

Delete the CR to uninstall memcached:

  1. kubectl delete -f config/samples/cache_v1_memcached.yaml

Use make undeploy to uninstall the operator and its CRDs:

  1. make undeploy

Next Steps

Read the tutorial for an in-depth walkthough of building a Ansible operator.

Last modified August 6, 2020: doc: migration guide for Ansible and quickstart fixes (#3571) (f04ad073)