jbw976

This document walks through a full upgrade and downgrade path acrosss multiple versions and API promotions using the usages.apiextensions.crossplane.io API.

The Crossplane and usages versions are summarized below:

Version	Description	Alpha	Beta	Migration
v1.18	most recent release, Usage is Alpha	storage, served	not exist	none
v1.19	promote Usage to beta	storage, served	served	migrate to alpha
v1.20	bump storage version to beta	served	storage, served	migrate to beta
v1.21	drop alpha	not exist	storage, served	none

jbw976

apiVersion: acme.com/v1
kind: AcmeDatabase
metadata:
  name: acme-db-prod
spec:
  storageGB: 15
  writeConnectionSecretToRef:
    name: acme-db-prod-conn

jbw976

apiVersion: database.example.org/v1alpha1
kind: AcmeCoDatabase
metadata:
  name: example-db
spec:
  parameters:
    storageGB: 20
  compositionRef:
    name: example

jbw976

> k get cloudsqlinstanceclass cloudsqlinstancepostgresql-standard -o yaml
apiVersion: database.gcp.crossplane.io/v1beta1
kind: CloudSQLInstanceClass
metadata:
  annotations:
    kubectl.kubernetes.io/last-applied-configuration: |
      {"apiVersion":"database.gcp.crossplane.io/v1beta1","kind":"CloudSQLInstanceClass","metadata":{"annotations":{},"labels":{"gitlab-ad-demo":"true"},"name":"cloudsqlinstancepostgresql-standard"},"specTemplate":{"forProvider":{"databaseVersion":"POSTGRES_9_6","region":"us-west2","settings":{"dataDiskSizeGb":10,"dataDiskType":"PD_SSD","ipConfiguration":{"privateNetwork":"projects/evident-beacon-246323/global/networks/default"},"tier":"db-custom-1-3840"}},"providerRef":{"name":"gcp-provider"},"reclaimPolicy":"Delete","writeConnectionSecretsToNamespace":"gitlab-managed-apps"}}
  creationTimestamp: "2019-11-16T03:07:05Z"
  generation: 1
  labels:

jbw976

> git diff
diff --git a/pkg/stacks/steps.go b/pkg/stacks/steps.go
index a89ab1ec..31a7a676 100644
--- a/pkg/stacks/steps.go
+++ b/pkg/stacks/steps.go
@@ -81,10 +81,6 @@ func crdStep(sp StackPackager) walker.Step {
                        return errors.Wrap(err, fmt.Sprintf("invalid crd %q", path))
                }
​
-               if (crd.Spec.Scope != apiextensions.NamespaceScoped) && (crd.Spec.Scope != "") {

jbw976

> k get crd gkeclusters.compute.gcp.crossplane.io -o yaml
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  annotations:
    app.kubernetes.io/managed-by: stack-manager
    stacks.crossplane.io/icon-data-uri: data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMjgiIGhlaWdodD0iMTI4IiB2aWV3Qm94PSIwIDAgMTI4IDEyOCI+CiAgPHRpdGxlPkNvbnRhaW5lciBFbmdpbmU8L3RpdGxlPgogIDxnPgogICAgPHBhdGggZD0iTTEyNi40Nyw1OC4xMmwtMjYuMy00NS43NEExMS41NiwxMS41NiwwLDAsMCw5MC4zMSw2LjVIMzcuN2ExMS41NSwxMS41NSwwLDAsMC05Ljg2LDUuODhMMS41Myw1OGExMS40OCwxMS40OCwwLDAsMCwwLDExLjQ0bDI2LjMsNDZhMTEuNzcsMTEuNzcsMCwwLDAsOS44Niw2LjA5SDkwLjNhMTEuNzMsMTEuNzMsMCwwLDAsOS44Ny02LjA2bDI2LjMtNDUuNzRBMTEuNzMsMTEuNzMsMCwwLDAsMTI2LjQ3LDU4LjEyWiIgc3R5bGU9ImZpbGw6ICM0Mjg1ZjQiLz4KICAgIDxwYXRoIGQ9Ik04OS42Myw0OC40NCw2NCwzNywzOS41LDUwLjMxbC0xLDI5LjMzTDgwLjMzLDEyMS41aDEwYTExLjczLDExLjczLDAsMCwwLDkuODctNi4wNmwyMC42MS0zNS44NVoiIHN0eWxlPSJvcGFjaXR5OiAwLjA3MDAwMDA

jbw976

> cloc .
    5557 text files.
    5194 unique files.
     736 files ignored.

github.com/AlDanial/cloc v 1.82  T=15.28 s (317.5 files/s, 98937.6 lines/s)
--------------------------------------------------------------------------------
Language                      files          blank        comment           code
--------------------------------------------------------------------------------
Go                             4242         116334         171468        1004293

jbw976

jared@jared-laptop ~/dev/go/src/github.com/crossplaneio/crossplane
> make help
Usage: make [make-options] <target> [options]

Common Targets:
    build        Build source code and other artifacts for host platform.
    build.all    Build source code and other artifacts for all platforms.
    clean        Remove all files created during the build.
    distclean    Remove all files created during the build including cached tools.
    lint         Run lint and code analysis tools.

jbw976

grep -F -R -l --exclude-dir=vendor '"log"' * | xargs grep -F -H 'log.'
pkg/test/envtest.go:		log.Fatal(err)
pkg/test/envtest.go:			log.Panic(err)
pkg/test/envtest.go:		log.Fatal(err)
pkg/test/envtest.go:			log.Fatal(err)
pkg/test/envtest.go:		log.Fatal(err)
pkg/test/envtest.go:			log.Panic(err)
pkg/test/envtest.go:			log.Panic(err)

jbw976

# Gopkg.toml
#
# Add constraints for packages that are a direct dependency
# of this project (i.e. they are imported by golang source code)
# and you want to ensure that only a specific version is needed.
# if you don't need a specific version don't add the constraint here.
# Constraints are of the form:
#
# [[constraint]]