@@ -52,14 +52,30 @@ go mod init
52
52
53
53
### Add client-go as a dependency
54
54
55
- Indicate which version of ` client-go ` your project requires (replace ` kubernetes-1.15.0 ` with the desired version):
55
+ Indicate which version of ` client-go ` your project requires:
56
+
57
+ - If you are using Kubernetes versions >= ` v1.17.0 ` , use a corresponding
58
+ ` v0.x.y ` tag. For example,
` k8s.io/[email protected] ` corresponds to Kubernetes
` v1.17.0 ` :
56
59
57
60
``` sh
58
-
61
+
62
+ ```
63
+
64
+ You can also use a non-semver ` kubernetes-1.x.y ` tag to refer to a version
65
+ of ` client-go ` corresponding to a given Kubernetes release. Prior to Kubernetes
66
+ ` v1.17.0 ` these were the only tags available for use with go modules.
67
+ For example, ` kubernetes-1.16.3 ` corresponds to Kubernetes ` v1.16.3 ` .
68
+ However, it is recommended to use semver-like ` v0.x.y ` tags over non-semver
69
+ ` kubernetes-1.x.y ` tags to have a seamless experience with go modules.
70
+
71
+ - If you are using Kubernetes versions < ` v1.17.0 ` (replace ` kubernetes-1.16.3 ` with the desired version):
72
+
73
+ ``` sh
74
+
59
75
```
60
76
61
77
You can now import and use the ` k8s.io/client-go ` APIs in your project.
62
78
The next time you ` go build ` , ` go test ` , or ` go run ` your project,
63
79
` k8s.io/client-go ` and its dependencies will be downloaded (if needed),
64
80
and detailed dependency version info will be added to your ` go.mod ` file
65
- (or you can also run ` go mod tidy ` to do this directly).
81
+ (or you can also run ` go mod tidy ` to do this directly).
0 commit comments