Skip to content

Commit 77bf305

Browse files
📖 (deployimage/v1-alpha) update the doc to reflect latest changes and add some small improvements
1 parent e116b54 commit 77bf305

File tree

1 file changed

+14
-12
lines changed

1 file changed

+14
-12
lines changed

docs/book/src/plugins/deploy-image-plugin-v1-alpha.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@
33
The deploy-image plugin allows users to create [controllers][controller-runtime] and custom resources which will deploy and manage an image on the cluster following
44
the guidelines and best practices. It abstracts the complexities to achieve this goal while allowing users to improve and customize their projects.
55

6+
By using this plugin you will have:
7+
- a controller implementation to Deploy and manage an Operand(image) on the cluster
8+
- tests to check the reconciliation implemented using [ENVTEST][envtest]
9+
- the custom resources samples updated with the specs used
10+
- you will check that the Operand(image) will be added on the manager via environment variables
11+
612
<aside class="note">
713
<h1>Examples</h1>
814

@@ -12,8 +18,9 @@ See the "project-v3-with-deploy-image" directory under the [testdata][testdata]
1218

1319
## When to use it ?
1420

15-
- This plugin is helpful for beginners who are getting started with scaffolding and using operators.
21+
- This plugin is helpful for those who are getting started.
1622
- If you are looking to Deploy and Manage an image (Operand) using [Operator pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/) and the tool the plugin will create an API/controller to be reconciled to achieve this goal
23+
- If you are looking to speed up
1724

1825
## How to use it ?
1926

@@ -35,19 +42,14 @@ The deploy-image plugin implements the following subcommands:
3542

3643
With the `create api` command of this plugin, in addition to the existing scaffolding, the following files are affected:
3744

38-
**When multigroup is not enabled**
39-
40-
- `controllers/*_controller.go`
41-
- `controllers/*_suite_test.go`
45+
- `controllers/*_controller.go` (scaffold controller with reconciliation implemented)
46+
- `controllers/*_controller_test.go` (scaffold the tests for the controller)
47+
- `controllers/*_suite_test.go` (scaffold/update the suite of tests)
4248
- `api/<version>/*_types.go` (scaffold the specs for the new api)
4349
- `config/samples/*_.yaml` (scaffold default values for its CR)
44-
45-
**When multigroup is enabled**
46-
47-
- `controllers/<group>/*_controller.go`
48-
- `controllers/<group>/*_suite_test.go`
49-
- `apis/<group>/<version>/*_types.go` (scaffold the specs for the new api)
50-
- `config/samples/*_.yaml` (scaffold default values for its CR)
50+
- `main.go` (update to add controller setup)
51+
- `config/manager.yaml` (update with envvar to store the image)
5152

5253
[controller-runtime]: https://github.com/kubernetes-sigs/controller-runtime
5354
[testdata]: https://github.com/kubernetes-sigs/kubebuilder/tree/master/testdata/
55+
[envtest]: ../reference/envtest.md

0 commit comments

Comments
 (0)