You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/book/src/plugins/deploy-image-plugin-v1-alpha.md
+14-12Lines changed: 14 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,12 @@
3
3
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
4
4
the guidelines and best practices. It abstracts the complexities to achieve this goal while allowing users to improve and customize their projects.
5
5
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
+
6
12
<asideclass="note">
7
13
<h1>Examples</h1>
8
14
@@ -12,8 +18,9 @@ See the "project-v3-with-deploy-image" directory under the [testdata][testdata]
12
18
13
19
## When to use it ?
14
20
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.
16
22
- 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
17
24
18
25
## How to use it ?
19
26
@@ -35,19 +42,14 @@ The deploy-image plugin implements the following subcommands:
35
42
36
43
With the `create api` command of this plugin, in addition to the existing scaffolding, the following files are affected:
37
44
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)
42
48
-`api/<version>/*_types.go` (scaffold the specs for the new api)
43
49
-`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)
0 commit comments