v1.0.0-beta.1

Overview

This is the first prerelease of Porter that supports migrating your old data from v0.38 to v! 🎉 Learn how to migrate from v0 to v1 at https://getporter.org/storage-migrate

What's Changed

• add blog post for the new secret plugin protocol by @VinozzZ in #2121
• Docs: When to use credentials vs parameters by @carolynvs in #2127
• Remove stale website content by @carolynvs in #2131
• Improve Porter's tagline by @carolynvs in #2123
• Fix build target on an arm dev machine by @carolynvs in #2144
• Storage fix-permissions should handle missing config by @carolynvs in #2145
• Fix two small typos in docs by @kevinbarbour in #2155
• Update k8s and containerd dependencies by @carolynvs in #2147
• Fix broken links in tutorial docs by @kevinbarbour in #2169
• Bump cnab-to-oci to v0.3.4 by @carolynvs in #2177
• use relocation map for pulling images during archive by @VinozzZ in #2149
• Add porter parameter create command by @joshuabezaleel in #2168
• fix parameter with space error by @Simpcyclassy in #2091
• Allow run stop time to be empty by @carolynvs in #2184
• Support customizing the test porter command by @carolynvs in #2183
• Fix timing on logging a plugin connection error by @carolynvs in #2185
• Refactor functions that create indices by @carolynvs in #2187
• Reduce smoke test suite size by @carolynvs in #2182
• staticcheck lint fixes by @tchaudhry91 in #2176
• Set the uninstalled flag on the installation by @carolynvs in #2189
• refactor: replace pkg/errors by golang built-in errors by @epsxy in #2175
• Add state and status to list installation by @joshuabezaleel in #2171
• Update Navigation Bar by @hrittikhere in #2195
• Copy latest changes from main to v1 by @carolynvs in #2194
• improve website design by @reveurguy in #2178
• Update relocation map during porter publish by @VinozzZ in #2186
• Add Yingrong to OWNERS by @VinozzZ in #2204
• Update our codeowners file by @carolynvs in #2208
• Persist run bundle as string by @carolynvs in #2200
• Recommend installing v1 by @carolynvs in #2206
• Change release-v1 links to go to main site by @carolynvs in #2207
• Ignore/Fix all remaining staticcheck errors by @tchaudhry91 in #2201
• Run Vet and Lint as part of validate phase in the pipeline by @tchaudhry91 in #2203
• Update error message when docker is not available by @tchaudhry91 in #2217
• Support migration of data from v0 to v1 by @carolynvs in #2150

New Contributors

• @epsxy made their first contribution in #2175
• @reveurguy made their first contribution in #2178

Full Changelog: v1.0.0-alpha.22...v1.0.0-beta.1

v1.0.0-alpha.22

What's Changed

• Improve error message loading wrong schema by @kevinbarbour in #2157
• Add prow github action by @carolynvs in #2163
• Switch prow to use pull_request instead of _target by @carolynvs in #2166
• Updated installation schema with correct dependency schema by @sgettys in #2165

New Contributors

• @sgettys made their first contribution in #2165

Full Changelog: v1.0.0-alpha.21...v1.0.0-alpha.22

v1.0.0-alpha.21

What's Changed

• Fix Vet Errors (#2153) by @tchaudhry91
• fix archive folder test #2160 by @VinozzZ
• Adding pagination for installation, parameter, and credential list result using skip and limit option (#2137) by @joshuabezaleel
• Sanitize archive folder name (#2154) by @VinozzZ
• Update to helm3 mixin v0.1.16 (#2148) by @carolynvs
• Use user specified directory for resolving file path (#2142) @VinozzZ
• Add vet and lint targets to magefile #2141 by @tchaudhry91
• Support Docker TLS environment variables #2134 by @carolynvs
• Rename DisplayRun.ClaimID to ID #2138 by @carolynvs
• Add InstallationStore.FindInstallations (#2119) by @carolynvs
• Increase plugin start/stop timeouts #2139 by @carolynvs
• Fix race condition in plugin logs routine (#2126) by @carolynvs
• change dependency schema in porter (#2117) by @VinozzZ
• Remove group from StorageProtocol.FindOptions (#2120) by @carolynvs
• Remove structured logs experimental flag #2113 by @carolynvs
• Sync release/v1 with main #2118 by @carolynvs
• Fix log messages from mongodb-docker #2116 by @carolynvs
• Refactor the bundle adapter #2110 by @carolynvs
• Show all blog posts on the blog page #2115 by @carolynvs
• Cleanup build-driver config setting #2114 by @carolynvs
• Add registry.ListTags #2109 by @carolynvs
• Remove unneeded ToLower #2112 by @tchaudhry91

v0.38.12

What's Changed

• Pin v0.38 install script to compatible package versions by @carolynvs in #2076
• Add shortlink to find an issue to work on by @carolynvs in #2086
• Find Issues link should only show open issues by @carolynvs in #2087
• Edit index.md for Typo by @hrittikhere in #2094
• Add GitLab to Registries by @hrittikhere in #2098
• Remove the github settings bot by @carolynvs in #2106
• Remove unneeded ToLower by @tchaudhry91 in #2112
• Show all blog posts on the blog page by @carolynvs in #2115
• add blog post for the new secret plugin protocol by @VinozzZ in #2121
• Backport changes to test bundles by @carolynvs in #2132
• Docs: When to use credentials vs parameters by @carolynvs in #2127
• Remove stale website content by @carolynvs in #2131
• Improve Porter's tagline by @carolynvs in #2123
• Fix build target on an arm dev machine by @carolynvs in #2144
• Storage fix-permissions should handle missing config by @carolynvs in #2145

New Contributors

• @hrittikhere made their first contribution in #2094

Full Changelog: v0.38.11...v0.38.12

v1.0.0-alpha.20

Breaking Changes

🚨 The plugin protocol has changed in this release of Porter. You must use the most recent version of any plugins with porter v1.0.0-alpha.20 and higher.

• Azure Plugin v1.0.0-beta.2
• Kubernetes Plugin v1.0.0-beta.3
• Hashicorp Plugin v0.1.0-porter.1 We are still waiting for the fix to be merged upstream, so you can use this fork of the hashicorp plugin until that's merged.

The installation schema has changed. Data created with previous versions of Porter will not work with this release. We will start providing migrations from v0.38.* when we hit v1.0.0-beta.1.

Overview

This was a big release! Most of the changes in this release were driven by one feature: Store sensitive data generated by Porter in an external secret store instead of in Porter's database. Previously, if a bundle generated a sensitive output, it was stored in Porter's database in plain text. Now if Porter needs to persist sensitive data, we save it back to your configured secret store. This required a change to the secret plugin protocol, which is why all the plugins have been updated.

A few supporting features also went into this release to improve our ability to debug and troubleshoot plugins:

• Distributed tracing support. We can now trace a porter command into the plugins that were called.
• Changed the plugin protocol from net/rpc to gRPC.
• Do not leak plugin connections when the user cancels a porter command. Porter now gracefully handles CTRL+C.

Features

• Save sensitive params into secret store (#1992) by @VinozzZ
• Update hashicorp plugin page with temp fork (#2108) by @carolynvs
• Add GitLab to Registries #2098 by @hrittikhere
• Support the interrupt signal SIGINT #2078 by @carolynvs
• Enable setting custom values during porter build. (#1900) by @joshuabezaleel
• Instrument plugins (#2026) by @carolynvs
• Add documentation for Create Porter's Configuration file under Task (#2045) by @VinozzZ
• add quickstart doc for porter configuration file (#2038) by @VinozzZ
• Add mixin version when building the bundle (#1952) by @joshuabezaleel
• increment installation schema version #2036 by @VinozzZ
• Add create a bundle task documentation #2007 by @carolynvs

Fixes

• Do not print "tools used" section on explain #2088 by @joshuabezaleel
• Switch from StringSlice to StringArray (#1931) by @Simpcyclassy
• Fix performance for porter list #2096 by @carolynvs
• Do not include plugin config in error (#2105) by @carolynvs
• Include the schema versions in migration errors #2103 by @carolynvs
• Edit index.md for Typo (#2094) by @hrittikhere
• Fix bson.D conversion in GRPC (#2083) by @VinozzZ
• Fix context passed when resolving secrets in config file #2068 by @carolynvs
• Fix plugin tracing again 😭 #2073 by @carolynvs
• Fix plugin load recursion #2071 by @carolynvs
• Do not load config for the bash completion command #2070 by @carolynvs
• Handle error when resolving config file secrets #2069 by @carolynvs
• pkg/storage: fix connection leak #2060 by @VinozzZ
• Fix enabling telemetry #2061 by @carolynvs
• Gracefully handle non-string custom values (#2043) by @carolynvs
• Fix nil panic in integration test #2042 by @VinozzZ
• [Docs] Add key config param flag for object parameter and escape string for double dash flag #2030 by @joshuabezaleel
• Fix file name misspell on pkg/cnab/parameter_sources_test.go #2039 by @joshuabezaleel
• Added reference parameter to the install command #1896 by @aguywithcode
• fix edge cases in docs #2024 by @qpetraroia
• Fix typo of close issues gh action #2023 by @carolynvs
• Use upstream close issues github action #2022 by @carolynvs

Misc

• update kubernetes-plugins doc (#2104) by @VinozzZ
• Sync from main #2101 by @carolynvs
• Support tracing the smoke and integration tests #2058 by @carolynvs
• update azure plugins documentation #2064 by @VinozzZ
• Update plugins overview #2092 by @carolynvs
• Find Issues link should only show open issues #2087 by @carolynvs
• Add shortlink to find an issue to work on #2086 by @carolynvs
• Bump secrets plugin protocol version to 2 (#2077) by @carolynvs
• Rename claims to installations #2053 by @carolynvs
• Consolidate storage-related packages into pkg/storage #2052 by @carolynvs
• Bump cnab-go to v0.23.2 #2054 by @carolynvs
• pkg/storage: add dash when formating sensitive data's key #2056 by @VinozzZ
• add documentation for storing sensitive data into secret store (#2033) by @VinozzZ
• [Docs] Complete sentence on "manage installation" doc #2028 by @joshuabezaleel
• Move examples into example-bundles repository (#2015) by @carolynvs

canary-v1

This is a canary build of the release/v1 branch. We don't recommend that you use it unless a maintainer asked you to try it out.

The canary-v1 tag is not fixed and will be force pushed as we continue to develop v1.

v0.38.11

What's Changed

• Added reference parameter to the install command by @aguywithcode in #1896
• Add probot settings configuration file by @carolynvs in #2011
• fix edge cases in docs by @qpetraroia in #2024
• Backport Switch from StringSlice to StringArray (#1931) by @carolynvs in #2046

New Contributors

• @aguywithcode made their first contribution in #1896
• @qpetraroia made their first contribution in #2024
• @tamirkamara made their first contribution in #2032

Full Changelog: v0.38.10...v0.38.11

v1.0.0-alpha.18

Overview

This release adds a bunch of useful docker features: build-arg, secret, ssh, improved layer caching and proxy support. A blog post is coming soon but at a high level, these flags give you the tool you need to more fully customize and control what is exposed in your bundle:

• Parameterize your bundle based on build arguments
• Download protected assets by and include them in your bundle by mounting secrets
• Clone private git repositories using a local ssh connection

Porter now builds with Docker buildkit by default. If you were previously using the experimental flag to enable buildkit and select a build-driver that is no longer necessary. Porter uses the latest Dockerfile syntax, 1.4.0 to speed up builds by improving how apt packages are cached and linking the bundle source code with the new COPY --link flag.

Porter now uses your local Docker client config so you can build bundles behind a proxy.

Give it a try and please send us any feedback on how it’s working, if there are any remaining gaps or Docker features that you need.

Features

• Add installation.namespace template var #2001 by @jemgoss
• Support additional docker flags and remove legacy docker build driver #1999 by @carolynvs

Fixes

• Check manifest schemaVersion in Porter commands before executing #1997 by @carolynvs
• Make runtime manifest log output debug messages #2005 by @carolynvs
• Support stringArray cobra flag type #1998
• Fix duplicate error message when command fails #1995

Misc

• Fix website BASEURL #2003 by @carolynvs
• Add GitHub action to scan our code and porter-agent image #1994