github/client-go
1
0
Fork 0
mirror of https://github.com/kubernetes/client-go.git synced 2025-06-26 15:12:06 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #319 from caesarxuchao/remove-dep

Browse Source 
Document that client-go is not yet compatible with dep
This commit is contained in:
Chao Xu 2017-11-01 12:11:50 -07:00 committed by GitHub
commit 72e1c2a1ef
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
INSTALL.md
View File

@ -143,38 +143,20 @@ After modifying, run `glide up -v` again to re-populate your /vendor directory.
Optionally, Glide users can also use [`glide-vc`](https://github.com/sgotti/glide-vc) Optionally, Glide users can also use [`glide-vc`](https://github.com/sgotti/glide-vc)
after running `glide up -v` to remove unused files from /vendor. after running `glide up -v` to remove unused files from /vendor.
### Dep ### Dep (Not supported yet!)
[dep](https://github.com/golang/dep) is an up-and-coming dependency management tool, [dep](https://github.com/golang/dep) is an up-and-coming dependency management
which has the goal of being accepted as part of the standard go toolchain. Its tool, which has the goal of being accepted as part of the standard go toolchain.
status is currently alpha. However, it comes the closest to working easily out However, client-go does **NOT** work well with `dep` yet. To support `dep`, we
of the box. need to fix at least two issues:
1. publish native `Gopkg.toml` in client-go and other k8s.io repos, like `k8s.io/apimachinery`;
2. find a way to express transitive constraints (see https://github.com/golang/dep/issues/1124).
```sh As a workaround, which may or may not be worthwhile, you can specify all
$ go get github.com/golang/dep client-go dependencies manually as
$ go install github.com/golang/dep/cmd/dep [override](https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md#override)
in Gopkg.toml with the versions listed in [Godeps.json](./Godeps/Godeps.json),
and manually update them when you upgrade client-go version.
# Make sure you have a go file in your directory which imports a package of We are actively working on the two issues blocking using `dep`. For the
# k8s.io/client-go first--I suggest copying one of the examples. meantime, we recommend using `glide` or `godeps`.
$ dep init
$ dep ensure k8s.io/client-go@^2.0.0
```
Then you can try one of the
[examples](https://github.com/kubernetes/client-go/tree/v2.0.0/examples/) from
the 2.0.0 release.
This will set up a `vendor` directory in your current directory, add `k8s.io/client-go`
to it, and flatten all of `k8s.io/client-go`'s dependencies into that vendor directory,
so that your code and `client-go` will both get the same copy of each
dependency.
After installing like this, you could either use dep for your other
dependencies, or copy everything in the `vendor` directory into your
`$GOPATH/src` directory and proceed as if you had done a fancy `go get` that
flattened dependencies sanely.
One thing to note about dep is that it will omit dependencies that aren't
actually used, and some dependencies of `client-go` are used only if you import
one of the plugins (for example, the auth plugins). So you may need to run `dep
ensure` again if you start importing a plugin that you weren't using before.