v1.0.0-beta.3

What's Changed

• Update install doc page with latest release version by @carolynvs in #2272
• Fix template name in .dockerignore by @jemgoss in #2276
• Add linter success message by @ThorstenHans in #2274
• update/validate cnab bundle schema version to 1.2.0 by @VinozzZ in #2270
• Fix referencing image that's not in local docker cache by @VinozzZ in #2282

Full Changelog: v1.0.0-beta.2...v1.0.0-beta.3

Install or Update

Follow the installation instructions at https://getporter.org/install/#recommended

v1.0.0-beta.2

Breaking Changes

🚨 This build of Porter has breaking changes. Please read before upgrading!

We have consolidated multiple flags into a single --verbosity flag that controls the console output verbosity.

• porter build --verbose has been removed. We now always print the docker build output. #2243
• The --debug and --debug-plugins flags have been removed. Use --verbosity=debug as a replacement. #2258

Notable Changes

• We are switching to the getporter.org domain by default in our documentation. The old domain porter.sh will still work.
• porter explain and inspect now allow passing the bundle reference either as a positional argument or with the --reference flag #2247
• The default template delimiters in porter.yaml have been changed from {{ }} to ${ }. See our blog post for more details.
• You can now properly reference an image in porter.yaml using a tag. When porter build is run, Porter resolves the tag to a digest and uses the digest instead of the tag, effectively pinning the image to the tag's digest at build time. This allows you to manage an image using tags, and still have an immutable bundle that uses digests at runtime. #2198
• The --cred flag is deprecated (but still supported) and has been replaced with --credential-set to be consistent with the other flag names. #2244
• The porter bundle install/upgrade/invoke/uninstall commands have been relocated to porter installation install/upgrade/invoke/uninstall. If you are using the shorter version of those commands, such as porter install or porter upgrade, you will not be affected by the change. #2255

Full Change Log

• Switch from porter.sh to getporter.org by @carolynvs in #2209
• Sync CI changes to the PR build by @carolynvs in #2211
• Removes Invert Filter from CNCF Logo by @hrittikhere in #2227
• changes for mobile view by @reveurguy in #2210
• Only load mixin metadata from used mixins by @carolynvs in #2214
• Bump cnab-to-oci to v0.3.5 by @carolynvs in #2229
• Fix dependencies v1 definition and conversion by @carolynvs in #2232
• Fix test flake TestPlugins_CatchStderr by @carolynvs in #2236
• Move current dependencies feature into depsv1 by @carolynvs in #2238
• Remove build --verbose, always print docker build output by @carolynvs in #2243
• Context plumbing by @carolynvs in #2242
• Add dependencies-v2 experimental flag by @carolynvs in #2246
• Doc: add mixin flow chart by @VinozzZ in #2250
• improved join community section, added cncf white logo by @reveurguy in #2249
• Refactor shared bundle action options by @carolynvs in #2245
• Allow reference as positional arg to explain/inspect by @carolynvs in #2247
• Render step template from original yaml by @carolynvs in #2248
• Documentation fixes related to migration by @jasmdk in #2259
• Rename --cred to --credential-set by @carolynvs in #2244
• Document new location of docker images by @carolynvs in #2264
• Move action commands under installations by @carolynvs in #2255
• update manifest to always use digest by @VinozzZ in #2198
• Consolidate --debug, --debug-plugins into --verbosity by @carolynvs in #2258
• Support ${} template delimiters by @carolynvs in #2252
• Fix allow docker host access by @carolynvs in #2268

New Contributors

• @jasmdk made their first contribution in #2259

Full Changelog: v1.0.0-beta.1...v1.0.0-beta.2

Install or Upgrade

See https://getporter.org/install for instructions

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