v1.0.0-alpha.11

Features

• pkg/context: add function to construct user agent string for porter (#1916) by @VinozzZ
• pkg/{config/context}: set log correlation id through env variable #1907 @VinozzZ
• pkg/{porter, cnab},cmd,docs: remove the capability to pass a file path to the -c and -p flags (#1906) by @VinozzZ
• Porter explain warns for docker host access (#1868) by @joshuabezaleel
• Switch from a fork of cnab-go to main #1920 by @carolynvs
• pkg: push invocation image under the same repo as the bundle (#1901) by @VinozzZ

Fixes

• pkg/schema, doc: improve doc for schema and bundle image reference (#1933) by @VinozzZ
• Fix up sub heading #1919 by @devigned
• Merge pull request #1910 from carolynvs/bump-install-prerelease
• Sync generated cli docs #1925 by @carolynvs
• Sync main into v1 #1924 by @carolynvs
• Fix assign to project github action #1923 by @carolynvs

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v1.0.0-alpha.10

Breaking Changes

• Remove deprecated tag field from bundle dependency #1902 by @VinozzZ

Features

• Add shell completion command #1844 by @mikebarkas
• Document our airgap example #1895 by @carolynvs
• Blog: Secret-free config file #1884
• Blog: IgnoreErrors and Az group command #1854 by @carolynvs

Fixes

• Only push the current invocation image tag #1903 @carolynvs
• Fix build status badge #1839 by @carolynvs
• docs: 1841 Fix typo and align template divs (#1842) by @mikebarkas
• Reduce heading whitespace on blog posts #1871 by @carolynvs
• Link v1 docs from main site #1850 by @carolynvs
• Add H1 anchor links #1847 by @mikebarkas
• Clarify prerelease install instructions #1898 by @carolynvs

Misc

• Update PR checklists #1861 by @carolynvs
• Sync release/v1 branch with main #1893 by @carolynvs
• Link to user survey on README #1894 by @carolynvs
• Use Go 1.17 #1885 by @carolynvs
• Add a shortlink to a user survey #1891 by @carolynvs
• Blog: IgnoreErrors and Az group command (#1854) by @carolynvs
• Sync main into v1 #1909 by @carolynvs
• Pin liquid to 1.3.0 #1904 by @carolynvs

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v0.38.9

Features

• Add shell completion command #1844

Fixes

• Only push the current invocation image tag #1903

Misc

• Clarify prerelease install instructions #1898
• Link to user survey on README #1894
• Blog: Secret-free config file #1884
• Add a shortlink to a user survey #1891
• Blog: IgnoreErrors and Az group command #1854
• Reduce heading whitespace on blog posts #1871
• Update PR checklists #1861
• Link v1 docs from main site #1850
• docs 1845: Add H1 anchor links #1847 by @mikebarkas
• Fix build status badge #1839
• Fix typo and align template divs #1842 by @mikebarkas

Install or Upgrade

v1.0.0-alpha.9

Features

• Add templating to porter config file #1879 by @carolynvs Learn more at https://porter.sh/blog/secret-free-config/
• Standardize table printing #1876 by @carolynvs

Fixes

• Only include required install params in explain command #1875 by @carolynvs
• docs/content/reference: fix typo in /reference/file-formats.md #1874 by @VinozzZ

Misc

• Fix the mixin install target #1883 by @carolynvs
• Consolidate rootLogger and scopedLogger #1878 by @carolynvs

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v1.0.0-alpha.8

Features

• Support uninstall through the installation apply command #1851 by @carolynvs
• pkg/{porter,tracing}, cmd/porter: add tracing instrumentation for list #1864 by @VinozzZ

Fixes

• pkg/config: fix Telemetry struct tag #1863 by @VinozzZ
• Print the porter version from the agent #1865 by @carolynvs

Misc

• Add back lost docker network logic to magefile #1866 by @carolynvs

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v1.0.0-alpha.7

This was a re-release of https://github.com/getporter/porter/releases/tag/v1.0.0-alpha.6 to fix a publish error.

v1.0.0-alpha.6

Features

• Add package for mixins magefile targets #1852 by @carolynvs
• Use structured logs and export traces #1831 by @carolynvs
• Change default registry to localhost:5000 #1855 by @mahendrabishnoi2
• Allow mixins to ignore a failed command (#1846) by @carolynvs
• Link to the stable docs from v1 site #1849 by @carolynvs
• Use a distroless base image (#1656) by @carolynvs
• Reorganize documentation (#1812) by @carolynvs
• Rename Dockerfile.tmpl to template.Dockerfile #1817 by @astroparam
• Use plaintext instead of table for human-readable output format. (#1803) by @joshuabezaleel
• docs: update parameters doc with allowable types (#1792) by @adnxn

Fixes

• Fix setting --driver with env variables #1848 by @carolynvs
• Pass context from integration tests #1859 by @carolynvs
• Porter triggers autobuild when detecting that invocation image does not exist (#1828) by @joshuabezaleel
• Improve error message when cnab-to-oci fixes up a bundle #1821 by @carolynvs
• Fix build driver experimental flag checks #1825 by @carolynvs
• Fix Pushing Bundles that have a relocationMap (#1815) by @anjayajodha
• Fix GetBuilder #1835 by @carolynvs
• Fix branch deploys of website #1837 by @carolynvs
• Fix branch deploy #1833 by @carolynvs
• Doc packr word fix #1834 by @avinashupadhya99
• docs: fix command in contrib tutorial #1810 by @astroparam

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v0.38.8

Fixes

• Fix Pushing Bundles that have a relocationMap by @anjayajodha in #1815
• Improve error message when cnab-to-oci fixes up a bundle by @carolynvs in #1821

Misc

• Blog about the helm3 v0.1.14 mixin release by @carolynvs in #1777
• Fix broken links by @carolynvs in #1786
• update helm3 mixin documentation to the latest release by @MChorfa in #1788
• docs: update parameters doc with allowable types by @adnxn in #1792
• docs: fix command in contrib tutorial by @astroparam in #1810
• Doc packr word fix by @avinashupadhya99 in #1834

New Contributors

• @adnxn made their first contribution in #1792
• @avinashupadhya99 made their first contribution in #1834
• @anjayajodha made their first contribution in #1815

Full Changelog: v0.38.7...v0.38.8

v1.0.0-alpha.5

Breaking Changes

We recommend reading the release notes from the other alphas to see all the new features, and read about breaking changes that have been introduced. The data storage format for the v1 of Porter is not yet fixed. We are not providing migrations for your data between pre-release versions. We will provide migrations from the stable version of Porter (v0.38) to the new v1 format when we have a release candidate. So don't use the v1 prereleases for anything important!

Features

• Include schemaType when exporting resource documents (#1805) by @carolynvs
• Make bundle a node in the installation schema (#1800) by @carolynvs
• Add installation instruction to porter explain command (#1773) by @joshuabezaleel

Fixes

• Fix retrieving the last logs for an installation (#1808) by @carolynvs
• Use an ipv4 network for test cluster and registry (#1806) by @carolynvs

Install or Upgrade

https://release-v1.porter.sh/install/#prerelease

v1.0.0-alpha.4

Breaking Changes

We recommend reading the release notes from the other alphas to see all the new features, and read about breaking changes that have been introduced. The data storage format for the v1 of Porter is not yet fixed. We are not providing migrations for your data between pre-release versions. We will provide migrations from the stable version of Porter (v0.38) to the new v1 format when we have a release candidate. So don't use the v1 prereleases for anything important!

What's Changed

• Update helm3 mixin doc by @MChorfa in #1749
• Properly format numbers parsed from jsonPath outputs by @carolynvs in #1755
• Use helm3 for the airgap example by @carolynvs in #1759
• Install the helm3 mixin on CI machine by @carolynvs in #1760
• Announce v1.0.0-alpha.3 by @carolynvs in #1768
• Continue installing the helm2 mixin by @carolynvs in #1774
• Remove debug print statement by @carolynvs in #1775
• Fix website typos by @carolynvs in #1776
• Use the helm3 mixin everywhere by @carolynvs in #1772
• Lock down file permissions by @carolynvs in #1770
• Make log persistence configurable by @carolynvs in #1780
• Reconcile installation upon apply by @carolynvs in #1764
• Add porter mixin create command by @joshuabezaleel in #1602
• Reduce how often we hit the database by @carolynvs in #1783
• Blog about the helm3 v0.1.14 mixin release by @carolynvs in #1777
• Fix broken links by @carolynvs in #1786
• update helm3 mixin documentation to the latest release by @MChorfa in #1788
• Add command to show historical runs of porter by @phillipahereza in #1779
• Sync operator with porter v1 by @carolynvs in #1785
• Sync main into release/v1 by @carolynvs in #1790
• Allow config env vars to be empty by @carolynvs in #1794
• Print applied file in debug mode by @carolynvs in #1796

Full Changelog: v1.0.0-alpha.3...v1.0.0-alpha.4

Install or Upgrade

We would love for you to try out v1.0.0-alpha.4 and send us any feedback that you have! Keep in mind that the v1 prerelease is not suitable for running with production workloads, and that data migrations will not be provided or supported for v1 prerelease.
The prerelease is intended for you to try out the new features in Porter, and provide feedback but won't work with existing installations.

One way to try out Porter without messing with your current installation of Porter is to install Porter into a different
PORTER_HOME directory.

MacOS

export PORTER_HOME=~/.porterv1
export VERSION="v1.0.0-alpha.4"
curl -L https://cdn.porter.sh/$VERSION/install-mac.sh | bash

Linux

export PORTER_HOME=~/.porterv1
export VERSION="v1.0.0-alpha.4"
curl -L https://cdn.porter.sh/$VERSION/install-linux.sh | bash

Windows

$PORTER_HOME="$env:USERPROFILE\.porterv1"
$VERSION="v1.0.0-alpha.4"
(New-Object System.Net.WebClient).DownloadFile("https://cdn.porter.sh/$VERSION/install-windows.ps1", "install-porter.ps1")
.\install-porter.ps1 -PORTER_HOME $PORTER_HOME

Now when you want to use the v1 version of Porter, set the PORTER_HOME environment variable and add it to your PATH.

Posix Shells

export PORTER_HOME=~/.porterv1
export PATH="$PORTER_HOME:$PATH"

PowerShell

$env:PORTER_HOME="$env:USERPROFILE\.porterv1"
$env:PATH+=";$env:PORTER_HOME"