Synch repo cluster-api-provider-powervs with machine-api-provider-powervs

.ci-operator.yaml

@@ -0,0 +1,4 @@
+build_root_image:
+  name: release
+  namespace: openshift
+  tag: rhel-8-release-golang-1.17-openshift-4.10

.gitignore

@@ -11,5 +11,4 @@
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
 
-# Dependency directories (remove the comment below to include it)
-# vendor/
+bin/

Dockerfile

@@ -0,0 +1,9 @@
+FROM registry.ci.openshift.org/openshift/release:golang-1.16 AS builder
+WORKDIR /go/src/github.com/openshift/cluster-api-provider-powervs
+COPY . .
+# VERSION env gets set in the openshift/release image and refers to the golang version, which interfers with our own
+RUN unset VERSION \
+ && GOPROXY=off NO_DOCKER=1 GOARCH=ppc64le make build
+
+FROM --platform=ppc64le registry.access.redhat.com/ubi8/ubi:8.4
+COPY --from=builder /go/src/github.com/openshift/cluster-api-provider-powervs/bin/machine-controller-manager /

Dockerfile.rhel

@@ -0,0 +1,9 @@
+FROM registry.ci.openshift.org/ocp/builder:rhel-8-golang-1.17-openshift-4.10 AS builder
+WORKDIR /go/src/github.com/openshift/cluster-api-provider-powervs
+COPY . .
+# VERSION env gets set in the openshift/release image and refers to the golang version, which interfers with our own
+RUN unset VERSION \
+ && GOPROXY=off NO_DOCKER=1 make build
+
+FROM registry.ci.openshift.org/ocp/4.10:base
+COPY --from=builder /go/src/github.com/openshift/cluster-api-provider-powervs/bin/machine-controller-manager /

Makefile

@@ -0,0 +1,127 @@
+# Copyright 2021 The Kubernetes Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+GO111MODULE = on
+export GO111MODULE
+GOFLAGS ?= -mod=vendor
+export GOFLAGS
+GOPROXY ?=
+export GOPROXY
+
+DBG ?= 0
+
+ifeq ($(DBG),1)
+GOGCFLAGS ?= -gcflags=all="-N -l"
+endif
+
+VERSION     ?= $(shell git describe --always --abbrev=7)
+REPO_PATH   ?= github.com/openshift/cluster-api-provider-powervs
+LD_FLAGS    ?= -X $(REPO_PATH)/pkg/version.Raw=$(VERSION) -extldflags "-static"
+MUTABLE_TAG ?= latest
+IMAGE        = origin-powervs-machine-controllers
+
+.PHONY: all
+all: generate build images check
+
+NO_DOCKER ?= 0
+
+ifeq ($(shell command -v podman > /dev/null 2>&1 ; echo $$? ), 0)
+	ENGINE=podman
+else ifeq ($(shell command -v docker > /dev/null 2>&1 ; echo $$? ), 0)
+	ENGINE=docker
+else
+	NO_DOCKER=1
+endif
+
+USE_DOCKER ?= 0
+ifeq ($(USE_DOCKER), 1)
+	ENGINE=docker
+endif
+
+ifeq ($(NO_DOCKER), 1)
+  DOCKER_CMD =
+  IMAGE_BUILD_CMD = imagebuilder
+else
+  DOCKER_CMD := $(ENGINE) run --rm -v "$(PWD)":/go/src/github.com/openshift/cluster-api-provider-powervs:Z -w /go/src/github.com/openshift/cluster-api-provider-powervs openshift/origin-release:golang-1.16
+  IMAGE_BUILD_CMD = $(ENGINE) build
+endif
+
+.PHONY: vendor
+vendor:
+	go mod tidy
+	go mod vendor
+	go mod verify
+
+.PHONY: generate
+generate: gogen goimports
+
+gogen:
+	$(DOCKER_CMD) go generate ./pkg/... ./cmd/...
+
+.PHONY: test
+test: ## Run tests
+	@echo -e "\033[32mTesting...\033[0m"
+	$(DOCKER_CMD) hack/ci-test.sh
+
+bin:
+	@mkdir $@
+
+.PHONY: build
+build: ## build binaries
+	$(DOCKER_CMD) CGO_ENABLED=0 go build $(GOGCFLAGS) -o "bin/machine-controller-manager" \
+               -ldflags "$(LD_FLAGS)" "$(REPO_PATH)/cmd/manager"
+
+.PHONY: images
+images: ## Create images
+ifeq ($(NO_DOCKER), 1)
+	./hack/imagebuilder.sh
+endif
+	$(IMAGE_BUILD_CMD) -t "$(IMAGE):$(VERSION)" -t "$(IMAGE):$(MUTABLE_TAG)" ./
+
+.PHONY: push
+push:
+	$(ENGINE) push "$(IMAGE):$(VERSION)"
+	$(ENGINE) push "$(IMAGE):$(MUTABLE_TAG)"
+
+.PHONY: check
+check: fmt vet lint test # Check your code
+
+.PHONY: unit
+unit: # Run unit test
+	$(DOCKER_CMD) go test -race -cover ./cmd/... ./pkg/...
+
+.PHONY: test-e2e
+test-e2e: ## Run e2e tests
+	 hack/e2e.sh
+
+.PHONY: lint
+lint: ## Go lint your code
+	$(DOCKER_CMD) hack/go-lint.sh -min_confidence 0.3 $$(go list -f '{{ .ImportPath }}' ./... | grep -v -e 'github.com/openshift/cluster-api-provider-powervs/test' -e 'github.com/openshift/cluster-api-provider-powervs/pkg/client/mock')
+
+.PHONY: fmt
+fmt: ## Go fmt your code
+	$(DOCKER_CMD) hack/go-fmt.sh .
+
+.PHONY: goimports
+goimports:
+	$(DOCKER_CMD) hack/goimports.sh .
+	hack/verify-diff.sh
+
+.PHONY: vet
+vet: ## Apply go vet to all go files
+	$(DOCKER_CMD) hack/go-vet.sh ./...
+
+.PHONY: help
+help:
+	@grep -E '^[a-zA-Z/0-9_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'

OWNERS

@@ -0,0 +1,8 @@
+reviewers:
+- mkumatag
+- Karthik-K-N
+approvers:
+- mkumatag
+
+component: "Cloud Compute"
+subcomponent: "Other Providers"

README.md

@@ -0,0 +1,88 @@
+# Machine API Provider Power VS
+
+This repository contains implementations of Power VS Provider for the
+OpenShift [machine-api](https://github.com/openshift/cluster-api).
+
+This provider runs as a machine-controller deployed by the
+[machine-api-operator](https://github.com/openshift/machine-api-operator)
+
+### How to build the images in the RH infrastructure
+The Dockerfiles use `as builder` in the `FROM` instruction which is not currently supported
+by the RH's docker fork (see [https://github.com/kubernetes-sigs/kubebuilder/issues/268](https://github.com/kubernetes-sigs/kubebuilder/issues/268)).
+One needs to run the `imagebuilder` command instead of the `docker build`.
+
+Note: this info is RH only, it needs to be backported every time the `README.md` is synced with the upstream one.
+
+## Deploy machine API plane with kubernetes cluster
+
+1. **Deploying the cluster**
+
+    Use any existing mechanism for deploying the kubernetes cluster, e.g: kubeadm https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/
+
+2. **Deploying machine API controllers**
+
+    For development purposes the powervs machine controller itself will run out of the machine API stack.
+    Otherwise, docker images needs to be built, pushed into a docker registry and deployed within the stack.
+
+    To deploy the stack:
+    ```
+    kustomize build config | kubectl apply -f -
+    ```
+
+3. **Deploy secret with Power VS credentials**
+
+   Power VS nodeupdate controller assumes existence of a secret file:
+
+   ```yaml
+   apiVersion: v1
+   kind: Secret
+   metadata:
+     name: powervs-credentials
+     namespace: openshift-machine-api
+   type: Opaque
+   data:
+     ibmcloud_api_key: FILLIN
+   ```
+
+   You can use `examples/render-powervs-secrets.sh` script to generate the secret:
+   ```sh
+   # Set the IBMCLOUD_API_KEY with a proper IBM Cloud API Key
+   $ IBMCLOUD_API_KEY=<API_KEY> ./examples/render-powervs-secrets.sh examples/addons.yaml | kubectl apply -f -
+   ```
+
+   Go to [How to create IBM Cloud API Key](#How-to-create-IBM-Cloud-API-Key) for creating API Key
+
+4. **Test by creating example machine**
+
+   ```shell
+   # Update the relevant fields like serviceInstanceID, imageID, subnets, keyName etc.. 
+   $ kubectl create -f examples/machine-with-user-data.yaml
+   $ kubectl create -f examples/userdata.yml
+   ```
+## Test locally built powervs actuator
+
+1. **Tear down machine-controller**
+
+   Deployed machine API plane (`machine-api-controllers` deployment) is (among other
+   controllers) running `machine-controller`. In order to run locally built one,
+   simply edit `machine-api-controllers` deployment and remove `machine-controller` container from it.
+
+
+2. **Build and run powervs actuator from outside the cluster**
+
+   ```sh
+   $ go build -o bin/machine-controller-manager github.com/openshift/cluster-api-provider-powervs/cmd/manager
+   ```
+
+   ```sh
+   $ .bin/machine-controller-manager --kubeconfig ~/.kube/config --logtostderr -v 5 -alsologtostderr
+   ```
+      If running in container with `podman`, or locally without `docker` installed, and encountering issues, see [hacking-guide](https://github.com/openshift/machine-api-operator/blob/master/docs/dev/hacking-guide.md#troubleshooting-make-targets).
+
+## How to create IBM Cloud API Key
+
+### Method 1: Create an API Key via IAM
+https://cloud.ibm.com/docs/account?topic=account-userapikey&locale=en#create_user_key
+
+### Method 2: Create an API Key via Service Account
+<!TODO: Add information>