Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kubernetes/cloud-provider-gcp
cloud-provider-gcp contains several projects used to run Kubernetes in Google Cloud
https://github.com/kubernetes/cloud-provider-gcp
cloud-providers google google-cloud
Last synced: 1 day ago
JSON representation
cloud-provider-gcp contains several projects used to run Kubernetes in Google Cloud
- Host: GitHub
- URL: https://github.com/kubernetes/cloud-provider-gcp
- Owner: kubernetes
- License: apache-2.0
- Created: 2018-03-21T07:01:09.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-28T07:58:25.000Z (3 months ago)
- Last Synced: 2024-10-29T14:57:52.697Z (3 months ago)
- Topics: cloud-providers, google, google-cloud
- Language: Go
- Homepage:
- Size: 157 MB
- Stars: 125
- Watchers: 31
- Forks: 209
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
- Security: SECURITY_CONTACTS
Awesome Lists containing this project
README
# cloud-provider-gcp
This repository holds the code for gcp-controller-manager as well as cloud-controller-manager
## Publishing gcp-controller-manager image
This command will build and publish gcp-controller-manager
`gcr.io/k8s-image-staging/gcp-controller-manager:latest`:
```
bazel run //cmd/gcp-controller-manager:publish
```
Environment variables `IMAGE_REGISTRY`, `IMAGE_REPO` and `IMAGE_TAG` can be
used to override destination GCR repository and tag.
This command will build and publish
`example.com/my-repo/gcp-controller-manager:v1`:
```
IMAGE_REGISTRY=example.com IMAGE_REPO=my-repo IMAGE_TAG=v1 bazel run //cmd/gcp-controller-manager:publish
```
## Publishing cloud-controller-manager image
This command will build and publish cloud-controller-manager
`gcr.io/k8s-image-staging/cloud-controller-manager:latest`:
```
bazel run //cmd/cloud-controller-manager:publish
```
Environment variables `IMAGE_REGISTRY`, `IMAGE_REPO` and `IMAGE_TAG` can be
used to override destination GCR repository and tag.
This command will build and publish
`example.com/my-repo/gcp-controller-manager:v1`:
```
IMAGE_REGISTRY=example.com IMAGE_REPO=my-repo IMAGE_TAG=v1 bazel run //cmd/cloud-controller-manager:publish
```
# Cross-compiling
Selecting the target platform is done with the `--platforms` option with `bazel`.
This command builds release tarballs for Windows:
```
bazel build --platforms=@io_bazel_rules_go//go/toolchain:windows_amd64 //release:release-tars
```
This command explicitly targets Linux as the target platform:
```
bazel build --platforms=@io_bazel_rules_go//go/toolchain:linux_amd64 //release:release-tars
```
# Dependency management
Dependencies are managed using [Go modules](https://github.com/golang/go/wiki/Modules) (`go mod` subcommands).
Note that builds are done with Bazel and not the Go tool. Don't follow public
Go module docs, instead use instructions in this readme.
## Working within GOPATH
If you work within `GOPATH`, `go mod` will error out unless you do one of:
- move repo outside of GOPATH (it should "just work")
- set env var `GO111MODULE=on`
## Add a new dependency
```
go get github.com/new/dependency && ./tools/update_vendor.sh
```
## Update an existing dependency
```
go get -u github.com/existing/dependency && ./tools/update_vendor.sh
```
## Update all dependencies
```
go get -u && ./tools/update_vendor.sh
```
Note that this most likely won't work due to cross-dependency issues or repos
not implementing modules correctly.
# Bazel
Bazel is required to build and release cloud-provider-gcp.
To install:
```sh
go get github.com/bazelbuild/bazelisk
alias bazel=bazelisk
```
To re-generate `BUILD` files:
```sh
tools/update_bazel.sh
```
# Tagging for new cloud-controller-manager versions
To trigger a new image for cloud-controller-manager, you need to add a git tag.
This needs to have the format `ccm/vX.Y.Z`. For example.
```
git tag -a ccm/v27.1.0 -m "CCM build for Kubernetes v1.27.1"
```
The major version X corresponds to the Kubernetes minor version. The minor
version Y corresponds to the Kubernetes patch version and the patch version Z
corresponds to the CCM patch version.