Skip to content

Commit

Permalink
Add API groups explanation to golang tutorial
Browse files Browse the repository at this point in the history
Signed-off-by: Jonathan Berkhahn <[email protected]>
  • Loading branch information
jberkhahn committed Aug 8, 2022
1 parent 07b7a7f commit ac46d56
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions website/content/en/docs/building-operators/golang/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,11 @@ cd $HOME/projects/memcached-operator
# so all API groups will be <group>.example.com
operator-sdk init --domain example.com --repo github.com/example/memcached-operator
```
`--domain` will be used as the prefix of the API group your custom resources will be created in.
API groups are a mechanism to group portions of the Kubernetes API. You're probably already familiar with
some of the core Kubernetes API groups, such as `apps` or `rbac.authorization.k8s.io`. You should name your
domain to group your resource types in meaningful group(s), both for ease of understanding and because these
groups determine how access can be controlled to your resource types using RBAC. For more information, see [the core Kubernetes docs](https://kubernetes.io/docs/reference/using-api/#api-groups) and [the Kubebuilder docs](https://book.kubebuilder.io/cronjob-tutorial/gvks.html).

To learn about the project directory structure, see [Kubebuilder project layout][kubebuilder_layout_doc] doc.

Expand Down

0 comments on commit ac46d56

Please sign in to comment.