Merge branch 'master' into refactor/controller-runtime-v0.2.0

Author: estroz

CHANGELOG.md

@@ -3,6 +3,7 @@
 ### Added
 
 - Document new compile-time dependency `mercurial` in user-facing documentation. ([#1683](https://github.com/operator-framework/operator-sdk/pull/1683))
+- Adds new flag `--zap-time-encoding` to the flagset provided by `pkg/log/zap`. This flag configures the timestamp format produced by the zap logger. See the [logging doc](https://github.com/operator-framework/operator-sdk/blob/master/doc/user/logging.md) for more information. ([#1529](https://github.com/operator-framework/operator-sdk/pull/1529))
 
 ### Changed
 

OWNERS

@@ -3,14 +3,12 @@ approvers:
   - AlexNPavel
   - estroz
   - shawn-hurley
-  - LiliC
   - joelanford
   - theishshah
 reviewers:
   - hasbro17
   - AlexNPavel
   - estroz
   - shawn-hurley
-  - LiliC
   - joelanford
   - theishshah

doc/user-guide.md

@@ -24,17 +24,17 @@ Follow the steps in the [installation guide][install_guide] to learn how to inst
 Use the CLI to create a new memcached-operator project:
 
 ```sh
-$ mkdir -p $HOME/projects/example.com/
-$ cd $HOME/projects/example.com/
-$ operator-sdk new memcached-operator
+$ mkdir -p $HOME/projects
+$ cd $HOME/projects
+$ operator-sdk new memcached-operator --repo=github.com/example-inc/memcached-operator
 $ cd memcached-operator
 ```
 
 To learn about the project directory structure, see [project layout][layout_doc] doc.
 
 #### A note on dependency management
 
-By default, `operator-sdk new` generates a `go.mod` file to be used with [Go modules][go_mod_wiki]. If you'd like to use [`dep`][dep_tool], set `--dep-manager=dep` when initializing your project, which will create a `Gopkg.toml` file with the same dependency information.
+By default, `operator-sdk new` generates a `go.mod` file to be used with [Go modules][go_mod_wiki]. The `--repo=<path>` flag is required when creating a project outside of `$GOPATH/src`, as scaffolded files require a valid module path. If you'd like to use [`dep`][dep_tool], set `--dep-manager=dep` when initializing your project, which will create a `Gopkg.toml` file with the same dependency information.
 
 ##### Go modules
 
@@ -102,12 +102,12 @@ $ operator-sdk generate k8s
 ```
 
 ### OpenAPI validation
-To update the OpenAPI validation section in the CRD `deploy/crds/cache_v1alpha1_memcached_crd.yaml`, run the following command. 
+To update the OpenAPI validation section in the CRD `deploy/crds/cache_v1alpha1_memcached_crd.yaml`, run the following command.
 
 ```console
 $ operator-sdk generate openapi
 ```
-This validation section allows Kubernetes to validate the properties in a Memcached Custom Resource when it is created or updated. An example of the generated YAML is as follows: 
+This validation section allows Kubernetes to validate the properties in a Memcached Custom Resource when it is created or updated. An example of the generated YAML is as follows:
 
 ```YAML
 spec:

doc/user/logging.md

@@ -14,6 +14,7 @@ By default, `zap.Logger()` will return a logger that is ready for production use
 * `--zap-encoder` string - Sets the zap log encoding (`json` or `console`)
 * `--zap-level` string or integer - Sets the zap log level (`debug`, `info`, `error`, or an integer value greater than 0). If 4 or greater the verbosity of client-go will be set to this level.
 * `--zap-sample` - Enables zap's sampling mode. Sampling will be disabled for integer log levels greater than 1.
+* `--zap-time-encoding` string - Sets the zap time format (`epoch`, `millis`, `nano`, or `iso8601`)
 
 ### A simple example
 

internal/pkg/scaffold/olm-catalog/csv.go

@@ -169,7 +169,7 @@ func getCSVFromFSIfExists(fs afero.Fs, path string) (*olmapiv1alpha1.ClusterServ
 
 	csv := &olmapiv1alpha1.ClusterServiceVersion{}
 	if err := yaml.Unmarshal(csvBytes, csv); err != nil {
-		return nil, false, errors.Wrap(err, path)
+		return nil, false, errors.Wrapf(err, "error unmarshalling CSV %s", path)
 	}
 
 	return csv, true, nil
@@ -346,28 +346,29 @@ func (s *CSV) updateCSVFromManifestFiles(cfg *CSVConfig, csv *olmapiv1alpha1.Clu
 		scanner := yamlutil.NewYAMLScanner(yamlData)
 		for scanner.Scan() {
 			yamlSpec := scanner.Bytes()
-			kind, err := k8sutil.GetKindfromYAML(yamlSpec)
+			typemeta, err := k8sutil.GetTypeMetaFromBytes(yamlSpec)
 			if err != nil {
-				return errors.Wrap(err, f)
+				return errors.Wrapf(err, "error getting type metadata from manifest %s", f)
 			}
-			found, err := store.AddToUpdater(yamlSpec, kind)
+			found, err := store.AddToUpdater(yamlSpec, typemeta.Kind)
 			if err != nil {
-				return errors.Wrap(err, f)
+				return errors.Wrapf(err, "error adding manifest %s to CSV updaters", f)
 			}
 			if !found {
-				if _, ok := otherSpecs[kind]; !ok {
-					otherSpecs[kind] = make([][]byte, 0)
+				id := gvkID(typemeta.GroupVersionKind())
+				if _, ok := otherSpecs[id]; !ok {
+					otherSpecs[id] = make([][]byte, 0)
 				}
-				otherSpecs[kind] = append(otherSpecs[kind], yamlSpec)
+				otherSpecs[id] = append(otherSpecs[id], yamlSpec)
 			}
 		}
 		if err = scanner.Err(); err != nil {
 			return err
 		}
 	}
 
-	for k := range store.crds.crKinds {
-		if crSpecs, ok := otherSpecs[k]; ok {
+	for id := range store.crds.crIDs {
+		if crSpecs, ok := otherSpecs[id]; ok {
 			for _, spec := range crSpecs {
 				if err := store.AddCR(spec); err != nil {
 					return err

internal/pkg/scaffold/olm-catalog/csv_updaters.go

@@ -17,19 +17,20 @@ package catalog
 import (
 	"bytes"
 	"encoding/json"
-	"fmt"
 	"strings"
 
 	"github.com/operator-framework/operator-sdk/pkg/k8sutil"
 
 	"github.com/ghodss/yaml"
 	olmapiv1alpha1 "github.com/operator-framework/operator-lifecycle-manager/pkg/api/apis/operators/v1alpha1"
 	olminstall "github.com/operator-framework/operator-lifecycle-manager/pkg/controller/install"
+	"github.com/pkg/errors"
 	log "github.com/sirupsen/logrus"
 	appsv1 "k8s.io/api/apps/v1"
 	corev1 "k8s.io/api/core/v1"
 	rbacv1 "k8s.io/api/rbac/v1"
 	apiextv1beta1 "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1beta1"
+	"k8s.io/apimachinery/pkg/runtime/schema"
 )
 
 // CSVUpdater is an interface for any data that can be in a CSV, which will be
@@ -207,7 +208,7 @@ func (u *InstallStrategyUpdate) Apply(csv *olmapiv1alpha1.ClusterServiceVersion)
 		u.updateClusterPermissions(s)
 		u.updateDeploymentSpecs(s)
 	default:
-		return fmt.Errorf("install strategy (%v) of unknown type", strat)
+		return errors.Errorf("install strategy (%v) of unknown type", strat)
 	}
 
 	// Re-serialize permissions into csv strategy.
@@ -240,40 +241,82 @@ func (u *InstallStrategyUpdate) updateDeploymentSpecs(strat *olminstall.Strategy
 
 type CustomResourceDefinitionsUpdate struct {
 	*olmapiv1alpha1.CustomResourceDefinitions
-	crKinds map[string]struct{}
+	crIDs map[string]struct{}
 }
 
 func (store *updaterStore) AddOwnedCRD(yamlDoc []byte) error {
 	crd := &apiextv1beta1.CustomResourceDefinition{}
 	if err := yaml.Unmarshal(yamlDoc, crd); err != nil {
 		return err
 	}
-	store.crds.Owned = append(store.crds.Owned, olmapiv1alpha1.CRDDescription{
-		Name:    crd.ObjectMeta.Name,
-		Version: crd.Spec.Version,
-		Kind:    crd.Spec.Names.Kind,
-	})
-	store.crds.crKinds[crd.Spec.Names.Kind] = struct{}{}
+	versions, err := getCRDVersions(crd)
+	if err != nil {
+		return errors.Wrapf(err, "failed to get owned CRD %s versions", crd.GetName())
+	}
+	for _, ver := range versions {
+		kind := crd.Spec.Names.Kind
+		crdDesc := olmapiv1alpha1.CRDDescription{
+			Name:    crd.ObjectMeta.Name,
+			Version: ver,
+			Kind:    kind,
+		}
+		store.crds.crIDs[crdDescID(crdDesc)] = struct{}{}
+		store.crds.Owned = append(store.crds.Owned, crdDesc)
+	}
 	return nil
 }
 
+func getCRDVersions(crd *apiextv1beta1.CustomResourceDefinition) (versions []string, err error) {
+	if len(crd.Spec.Versions) != 0 {
+		for _, ver := range crd.Spec.Versions {
+			// Only versions served by the API server are relevant to a CSV.
+			if ver.Served {
+				versions = append(versions, ver.Name)
+			}
+		}
+	} else if crd.Spec.Version != "" {
+		versions = append(versions, crd.Spec.Version)
+	}
+	if len(versions) == 0 {
+		return nil, errors.Errorf("no versions in CRD %s", crd.GetName())
+	}
+	return versions, nil
+}
+
+// crdDescID produces an opaque, unique string identifying a CRDDescription.
+func crdDescID(desc olmapiv1alpha1.CRDDescription) string {
+	// Name should always be <lower kind>.<group>, so this is effectively a GVK.
+	splitName := strings.Split(desc.Name, ".")
+	return getGVKID(strings.Join(splitName[1:], "."), desc.Version, desc.Kind)
+}
+
+// gvkID produces an opaque, unique string identifying a GVK.
+func gvkID(gvk schema.GroupVersionKind) string {
+	return getGVKID(gvk.Group, gvk.Version, gvk.Kind)
+}
+
+func getGVKID(g, v, k string) string {
+	return g + v + k
+}
+
 // Apply updates csv's "owned" CRDDescriptions. "required" CRDDescriptions are
 // left as-is, since they are user-defined values.
+// Apply will only make a new spec.customresourcedefinitions.owned element if
+// the CRD key is not in spec.customresourcedefinitions.owned already.
 func (u *CustomResourceDefinitionsUpdate) Apply(csv *olmapiv1alpha1.ClusterServiceVersion) error {
 	set := make(map[string]olmapiv1alpha1.CRDDescription)
-	for _, csvDesc := range csv.Spec.CustomResourceDefinitions.Owned {
-		set[csvDesc.Name] = csvDesc
+	for _, uDesc := range u.Owned {
+		set[crdDescID(uDesc)] = uDesc
 	}
-	du := u.DeepCopy()
-	for i, uDesc := range u.Owned {
-		if csvDesc, ok := set[uDesc.Name]; ok {
-			csvDesc.Name = uDesc.Name
-			csvDesc.Version = uDesc.Version
-			csvDesc.Kind = uDesc.Kind
-			du.Owned[i] = csvDesc
+	newDescs := []olmapiv1alpha1.CRDDescription{}
+	for _, csvDesc := range csv.Spec.CustomResourceDefinitions.Owned {
+		if uDesc, ok := set[crdDescID(csvDesc)]; !ok {
+			newDescs = append(newDescs, uDesc)
+		} else {
+			newDescs = append(newDescs, csvDesc)
 		}
 	}
-	csv.Spec.CustomResourceDefinitions.Owned = du.Owned
+	csv.Spec.CustomResourceDefinitions.Owned = newDescs
 	return nil
 }
 

internal/util/k8sutil/k8sutil.go

@@ -15,11 +15,16 @@
 package k8sutil
 
 import (
+	"bytes"
 	"fmt"
+	"io"
 	"strings"
 	"unicode"
 
-	"github.com/ghodss/yaml"
+	"github.com/pkg/errors"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
+	"k8s.io/apimachinery/pkg/util/yaml"
 	"k8s.io/client-go/rest"
 	"k8s.io/client-go/tools/clientcmd"
 	clientcmdapi "k8s.io/client-go/tools/clientcmd/api"
@@ -55,16 +60,6 @@ func GetKubeconfigAndNamespace(configPath string) (*rest.Config, string, error)
 	return kubeconfig, namespace, nil
 }
 
-func GetKindfromYAML(yamlData []byte) (string, error) {
-	var temp struct {
-		Kind string
-	}
-	if err := yaml.Unmarshal(yamlData, &temp); err != nil {
-		return "", err
-	}
-	return temp.Kind, nil
-}
-
 // GetDisplayName turns a project dir name in any of {snake, chain, camel}
 // cases, hierarchical dot structure, or space-delimited into a
 // space-delimited, title'd display name.
@@ -99,3 +94,22 @@ func GetDisplayName(name string) string {
 	}
 	return strings.TrimSpace(strings.Title(strings.Join(splitName, " ")))
 }
+
+// GetTypeMetaFromBytes gets the type and object metadata from b. b is assumed
+// to be a single Kubernetes resource manifest.
+func GetTypeMetaFromBytes(b []byte) (t metav1.TypeMeta, err error) {
+	u := unstructured.Unstructured{}
+	r := bytes.NewReader(b)
+	dec := yaml.NewYAMLOrJSONDecoder(r, 8)
+	// There is only one YAML doc if there are no more bytes to be read or EOF
+	// is hit.
+	if err := dec.Decode(&u); err == nil && r.Len() != 0 {
+		return t, errors.New("error getting TypeMeta from bytes: more than one manifest in b")
+	} else if err != nil && err != io.EOF {
+		return t, errors.Wrap(err, "error getting TypeMeta from bytes")
+	}
+	return metav1.TypeMeta{
+		APIVersion: u.GetAPIVersion(),
+		Kind:       u.GetKind(),
+	}, nil
+}