v0.28.0

🚨Major Release

This is a major release for us and involves a data migration. Porter will let you know if your data is in the old format and will prompt you to migrate your data. Our data migration page has instructions on how to prepare for the migration.

This change supports the big feature for this release: supporting the updated CNAB Claims spec. Porter can now track changes to an installation across multiple actions and remember an installation even after it has been uninstalled. Now you can see the full history of what actions have been performed on your bundle.

We also have improved support for outputs and re-injecting them back into the bundle on subsequent actions transparently so that your bundle can rely upon state. For example, if your bundle uses Terraform and uses a tfstate file, Porter can handle giving your bundle the latest tfstate file so that you don't have to use a remote storage backend with your bundle. This works with any output, not just for Terraform.

You can use an output in your bundle either directly as a parameter or using Porter's templating language.

⚠️ Breaking Change: Run porter plugins install azure to get the latest version of the Azure plugin. Also read how to migrate the Azure Plugin Data.

⚠️ Breaking Change: The command porter instances has been renamed to porter installations. For example:

$ porter installations list
$ porter installation show mybun
$ porter installation outputs list
$ porter installation output show ip-address

Features

• Use latest claims code in cnab-go #1065
• Claim data migration #1090
• Show installation history #1152
• Support Parameter Source Extension at Runtime #1129
• Generate and resolve parameter sources from templating #1158
• Added Client Version for Kubernetes Mixin #1221 by @donmstewart
• Add installation delete options/flags to relevant commands #1189
• Migrate storage command #1212
• Migrate credential and parameter sets to have schemaVersion #1218
• Update applyTo on a param, if needed #1190
• Defer to bundle-level output def sensitivity #1206
• Update azure terraform bundle (#1207)
• Sync go.sum #1228
• Flag dep output wiring parameters as internal #1222
• Add logic to better determine if a param is internal to Porter #1202
• Support bundle dependencies with new claims spec #1193
• Misc code, comment, docs updates around claims #1204
• Documentation to explain github workflow #1201 by @gaurimadhok
• YAML for bundle to set up discourse #1182 by @gaurimadhok
• Ensure tag flags are applied consistently #1196
• Update archive command to require --tag #1195
• Bump cnab-go v0.13.3 #1194
• Fix check for GOPATH/bin #1186 by @simongdavies
• Wire up local registry targets for cli and int tests #1185
• Update porter.yaml template and clean up documentation and test data that use manifest template #1173
• Fix listing of parameter sources in order #1181
• Clean up the build image documentation. #1171 by @iennae
• Do not hard-code version in manifest tag #1172
• Improve plugin connection handling #1178
• Add proposal template #1165
• Bump cnab-go to v0.13.2 #1176
• Updates makefile so make fails with an error if packr2 is not installed and ${GOPATH}/bin is not in path #1156 by @simongdavies
• Add new contributors to Porter team #1168

Fixes

• 🐛 Skip bundle defaults if --tag passed #1199 by @dev-drprasad
• Ignore manifest if cnab-file provided #1200
• Fix resolution for step- and bundle-level outputs #1205
• Fix migrate credential log message #1230
• Fix unit test ValidateFeedURL and ValidateURL #1160 by @MChorfa
• Porter debug #1225
• Return error if parent dir of dest file does not exist #1179
• Fix formatting of configuration page #1187
• Remove brigade assets #1191
• Update sed command for compat w/ Mac/BSD sed #1184
• Handle removing stopped local registry in stop-local-docker-registry #1216

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.27.2

This release brings a host of features, fixes and updates to Porter. Here are some highlights. ☄️

Features

• Suffix argument support has been added to the exec/builder pkg, thanks to @gaurimadhok via (#1144) 7f8f945

• Implementation of this functionality is now in the exec mixin itself with 87aad2f

  For instance, now a shell command such as ssh host -l username -p port uname can be represented via the following:

  install:
    - exec:
        description: "Run uname via ssh"
        command: ssh
        arguments:
          - host
        flags:
          l: username
          p: port
        suffix-arguments:
          - uname

• Speaking of mixin updates, the kubernetes mixin now features support for --context, thanks to @MChorfa via (#1143) b9fa261

• Confused on whether to issue porter version or porter --version to get the CLI version? Why not both?! (#1125) e644d00

Fixes

• Parameter Set support for Porter's file type is now in via (#1137) aee93e9
• Invocation Images are now properly renamed per the supplied bundle --tag value on porter publish: (#1127) 9d0a837

Updates

• CI has been streamlined in 15f30e9
  • We've switched to ephemeral resources for the underlying Kubernetes cluster (via KinD) and Docker registry for publishing (via Docker's registry container) for our cli and integration tests.
  • This means our full suite of tests now run automagically on all PRs!
  • Big thanks to @MChorfa for excellent prior art on using Porter with KinD.
• The invocationImage field has now officially been removed from the Porter manifest, making it no longer user-specifiable: (#1140) 1e2d7ab
• Official communication channels for Porter have been updated; check out the Contact section of the README d49f7bc

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.27.1

This is a patch release including the following fixes and refactors:

• Fix TestDependencySolver_ResolveDependencies Flake 8e1d56c
• feat(*): support dependency params in Parameter Set (#1103) 4f303a6
• ref(ci): remove terraform cli test/assets d3892e5
• Set PORTER_HOME in integration tests on plugins 80410d9
• Trigger PR builds on any branch 9b3299f
• Add contributors file (#1106) c799ca6
• Remove internal params in explain output (#1101) d852cdd by @dev-drprasad

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.27.0

Features

• remove dry-run flags from from porter credentials generate #1094 by @adelowo
• Remove dry-run backend implementation #1095
• Introduce Parameter Set #1068
• add parameter set commands #1078
• Removes --param-file flag/logic in favor of parameter set #1076
• Add airgap example #1042
• Change defaulting of bundle/image tags #1075

Fixes

• Parse dependency references using docker library #1098
• docs(*): add parameters links to config; fix typo #1093
• fixes to install scripts for path set up #1088 by @gaurimadhok
• Fix setting message parameter in the airgap example #1084
• Fix release build #1083
• Handle plugin command's stderrs #1028 by @dev-drprasad
• Fix duplicate question while up/down-ing, while surveying #1056 by @dev-drprasad
• Fix specifying credentials by path #1071

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.26.3-beta.1

Fixes

• Run build before integration test #1061
• Selectively replace the org when moving images #1047
• update archive cmd text #1058
• Fix distribute bundles page text #1059
• add a few missing parameters config items #1054
• Use GoTool Task #1052
• #1048 from carolynvs/fix-link
• Fix link on copy bundles page #1033
• Cleaned up documentation for initial developer setup. (#1022)
• bump cnab-go dependency #1025

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.26.2-beta.1

Fixes

• add test around docker driver config #1012
• Skip params at runtime that don't apply #1017
• Fix description for whalesay invoke action #1014
• Fix formatting for required docker extension #1015
• update terraform bundle #1013
• Doc docker-compose mixin #1008
• remove immediate containers after innovation image built in docker provider's build action #1005 by @fenngwd
• Fix missing slack link in contributing guide #1003
• Document GitHub Package Registry failure #1004 by @iennae
• remove zero value/default param logic #994
• Move contribution ladder into separate document #1001
• Merge hotfix: Stop invoke when claim not found #949
• Add an example docker bundle #998

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.26.1-beta.1

Fixes

• Fix regression in loading bundle from claim #982
• Migrate claim data on read #984
• Remove old cached bundle on refresh #993
• Add --force flag to commands that pull tags #995
• actually propogate mixin runErr #989
• Update schema to set invocation image optional #986
• Fix docker required extension schema and processing #985
• fix(migrateClaimsWrapper_test.go): sort list before validation #987

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.26.0-beta.1

Features

• Add --allow-docker-host-access flag #970
• Stamp bundles with mixins and encoded manifest #976
• Add back in defaulting parameters of dependencies (#800)
• Define required extensions in porter.yaml (#977)
• Add docker as a well-known required extension (#979)

Fixes

• Explain allow-docker-host-access configuration setting (#962)
• Document suppress-output for the exec mixin (#963)
• Add issue templates for features and questions (#967)
• Explain plugins on the listing page (#966)
• Document suppress-output for mixins that support it (#965)
• update mixin regex to allow for numbers (#968)
• update the mixin regex to support hyphens (#971)
• update schema URL to use cnab.io (#972)

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.25.0-beta.1

Features

• Split mixin command args by whitespace (#931)
• Add best practice for the exec mixin (#942)
• Add lint command and run linter automatically during porter build (#953)
• Add interface for a mixin to suppress output (#956)
  • Each mixin needs to cut a new release to add support for this. So far just the exec, aws, az and gcloud mixins support it.
• Add ability to access Docker host (#951) by @jdolitsky

Fixes

• Read .dockerignore during porter build (#961)
• Fix help text for porter credentials (#941) by @jdolitsky
• Updated homepage to explain Porter better (#929)
• Simplify porter command navigation (#957)
• Add shortcut links for external resources (#958)

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.

v0.24.0-beta.1

Features

• Add edit credentials command (#921) by @halkyon
• Decouple package lists from CLI (#930)
• Add plugin search (#920)
• Add mixin search (#882)
• Add delete credentials command (#889) by @adamreese

Fixes

• Fix whitespace wrapping in code blocks (#917)
• Remove function creating credential add command (#910) by @scriptonist
• Throw error to user when empty step found in manifest (#896) by @dev-drprasad

Misc/Docs

• Digital Ocean works with cnab-to-oci (#933)
• Add redirects for our project boards (#926)
• Explain why we need credential sets (#916)
• Add docs/example around file parameter usage (#912)
• CI: Detect documentation-only builds (#911)
• Plugin tutorial (#905)

Install or Upgrade

Run (or re-run) the installation from https://porter.sh/install to get the latest version of porter.