getporter/porter v1.0.0 on GitHub

Overview

If you are migrating from Porter v1, please read the migration instructions at https://getporter.org/storage-migrate/.

Below are some helpful blog posts explaining some of the changes in v1:

Install or Upgrade

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

Remember to install the most recent version of your plugins and mixins! Use porter mixins install NAME --version VERSION or porter plugins install NAME --version VERSION to install the latest prerelease.

What's Changed

Upgrade to Go 1.16 and use go:embed by @carolynvs in #1568
Remove GO111MODULE and require Go 1.16 by @carolynvs in #1581
Add new build driver for buildkit by @carolynvs in #1567
Add support for maintainers by @ThorstenHans in #1572
Only install exec mixin with Porter by @carolynvs in #1588
Rearrange dependencies syntax to be nested in 'requires' object by @ThorstenHans in #1573
Count only the parameters in the parameter set by @divbhasin in #1608
Sync cli command documentation by @carolynvs in #1610
Display more installation information with show by @carolynvs in #1605
Bump cnab-go to v0.20.0 by @carolynvs in #1611
Small grammar fix by @divbhasin in #1622
feat(manifest): add parameter/output schema validation by @vdice in #1619
Provide autocomplete for jsonschema fields on parameters and outputs by @carolynvs in #1629
Fix v1 build by @carolynvs in #1632
Fix v1 release build by @carolynvs in #1637
Skip publish for v1 canary and latest by @carolynvs in #1641
Fix branch name detection by @carolynvs in #1642
ref(*): remove support for deprecated fields on manifest by @vdice in #1633
Document object parameters by @carolynvs in #1645
Sync v1 by @carolynvs in #1653
Sync v1 branch with main by @carolynvs in #1669
Bump cnab-go to v0.20.2 by @carolynvs in #1695
Support Installation Specification by @carolynvs in #1684
Sync v1 with main by @carolynvs in #1714
Support labels by @carolynvs in #1701
All namespaces by @carolynvs in #1712
Add apply command for creds and params by @carolynvs in #1715
Remove deprecated tag by @carolynvs in #1718
Update help text description of porter by @carolynvs in #1722
Always pull the invocation image by @carolynvs in #1723
Apply installation by @carolynvs in #1720
chore(examples/azure-terraform): updates per forthcoming 0.8.0 release by @vdice in #1732
Remove stopped mongo by @carolynvs in #1735
Revert "Always pull the invocation image (#1723)" by @carolynvs in #1736
Always collect outputs even when bundle fails by @carolynvs in #1728
Allow repeating install when --force is specified by @carolynvs in #1726
Fix(#1217): Improve parameters loading by first trying file if not then treat as named set. by @fibonacci1729 in #1731
Move mage targets by @carolynvs in #1737
Sync v1 with the main branch by @carolynvs in #1740
Add ExtendedBundle wrapper by @carolynvs in #1739
Include list of mixins used in porter explain and simplify explain output by @carolynvs in #1741
Update bundle action commands to work with the installation record by @carolynvs in #1724
Remove debug print statement by @carolynvs in #1747
Use official mongodb driver by @carolynvs in #1745
Bump CI environment variables by @carolynvs in #1750
Bump CI environment variables on v1 branch by @carolynvs in #1751
Update helm3 mixin doc by @MChorfa in #1749
Add state section to porter.yaml by @carolynvs in #1743
Properly format numbers parsed from jsonPath outputs by @carolynvs in #1755
Use helm3 for the airgap example by @carolynvs in #1759
Refactoring before adding reconcilation by @carolynvs in #1753
Hide internal outputs from porter installation outputs list by @carolynvs in #1761
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
docs: update parameters doc with allowable types by @adnxn in #1792
Allow config env vars to be empty by @carolynvs in #1794
Print applied file in debug mode by @carolynvs in #1796
Add installation instruction to porter explain command by @joshuabezaleel in #1773
Make bundle a node in the installation schema by @carolynvs in #1800
Include schemaType when exporting resource documents by @carolynvs in #1805
Use an ipv4 network for test cluster and registry by @carolynvs in #1806
Fix retrieving the last logs for an installation by @carolynvs in #1808
Use plaintext instead of table for human-readable output format. by @joshuabezaleel in #1803
docs: fix command in contrib tutorial by @f1rstmehul in #1810
Improve error message when cnab-to-oci fixes up a bundle by @carolynvs in #1821
Rename Dockerfile.tmpl to template.Dockerfile by @f1rstmehul in #1817
Reorganize documentation by @carolynvs in #1812
Fix build driver experimental flag checks by @carolynvs in #1825
Doc packr word fix by @avinashupadhya99 in #1834
Fix branch deploy by @carolynvs in #1833
Fix branch deploys of website by @carolynvs in #1837
Fix GetBuilder by @carolynvs in #1835
Fix Pushing Bundles that have a relocationMap by @anjayajodha in #1815
Use a distroless base image by @carolynvs in #1656
docs: 1841 Fix typo and align template divs by @mikebarkas in #1842
Sync v1 by @carolynvs in #1840
Fix build status badge by @carolynvs in #1839
1757 completion command by @mikebarkas in #1844
docs 1845: Add H1 anchor links by @mikebarkas in #1847
Link v1 docs from main site by @carolynvs in #1850
Link to the stable docs from v1 site by @carolynvs in #1849
Allow mixins to ignore a failed command by @carolynvs in #1846
Change default registry to localhost:5000 by @mahendrabishnoi2 in #1855
Fix setting --driver with env variables by @carolynvs in #1848
Porter triggers autobuild when detecting that invocation image does not exist by @joshuabezaleel in #1828
Use structured logs and export traces by @carolynvs in #1831
Pass context from integration tests by @carolynvs in #1859
Add package for mixins magefile targets by @carolynvs in #1852
Use porter from the bin or the PATH by @carolynvs in #1860
Update PR checklists by @carolynvs in #1861
pkg/config: fix Telemetry struct tag by @VinozzZ in #1863
Add back lost docker network logic to magefile by @carolynvs in #1866
Print the porter version from the agent by @carolynvs in #1865
pkg/{porter,tracing}, cmd/porter: add tracing instrumentation for list by @VinozzZ in #1864
Support uninstall through the installation apply command by @carolynvs in #1851
Fix bad merge by @carolynvs in #1872
docs/content/reference: fix typo in /reference/file-formats.md by @VinozzZ in #1874
Reduce heading whitespace on blog posts by @carolynvs in #1871
Blog: IgnoreErrors and Az group command by @carolynvs in #1854
Consolidate rootLogger and scopedLogger by @carolynvs in #1878
Standardize table printing by @carolynvs in #1876
Only include required install params in explain command by @carolynvs in #1875
Fix the mixin install target by @carolynvs in #1883
Add templating to porter config file by @carolynvs in #1879
Add a shortlink to a user survey by @carolynvs in #1891
Blog: Secret-free config file by @carolynvs in #1884
Use Go 1.17 by @carolynvs in #1885
Link to user survey on README by @carolynvs in #1894
Sync release/v1 branch with main by @carolynvs in #1893
Document our airgap example by @carolynvs in #1895
Clarify prerelease install instructions by @carolynvs in #1898
pkg/{cnab, manifest, runtime}: remove deprecated tag field from bundle dependency by @VinozzZ in #1902
Only push the current invocation image tag by @carolynvs in #1903
Pin liquid to 1.3.0 by @carolynvs in #1904
Sync main into v1 by @carolynvs in #1909
Update install prerelease instructions by @carolynvs in #1910
pkg: push invocation image under the same repo as the bundle by @VinozzZ in #1901
Fix up sub heading by @devigned in #1919
Fix assign to project github action by @carolynvs in #1923
Sync main into v1 by @carolynvs in #1924
Sync generated cli docs by @carolynvs in #1925
Switch from a fork of cnab-go to main by @carolynvs in #1920
Fix typos in docs by @sakkshm26 in #1915
Porter explain warns for docker host access by @joshuabezaleel in #1868
Fix close issues workflow by @carolynvs in #1927
pkg/{porter, cnab},cmd,docs: remove the capability to pass a file path to the -c and -p flags by @VinozzZ in #1906
Revert "Merge pull request #1927 from carolynvs/fix-close-issue-action" by @carolynvs in #1929
pkg/{config/context}: set log correlation id through env variable by @VinozzZ in #1907
pkg/context: add function to construct user agent string for porter by @VinozzZ in #1916
docs: add redirect for schema by @VinozzZ in #1943
pkg/schema, doc: improve doc for schema and bundle image reference by @VinozzZ in #1933
Add porter credentials create command by @joshuabezaleel in #1838
Prevent bad config from causing trouble by @carolynvs in #1938
Build invocation images that run as nonroot user by @carolynvs in #1930
pkg/version: make user-agent more unique by @VinozzZ in #1958
enable steps to define environment variables by @devigned in #1918
Move created/modified to status for params/creds by @carolynvs in #1957
mage: add checksum for published assets by @VinozzZ in #1950
Assign (none) for empty schemaVersion on applying installation by @joshuabezaleel in #1963
Fix close issue workflow by @carolynvs in #1965
Add schemaVersion to porter.yaml by @carolynvs in #1946
Fix docs for the secrets protocol by @carolynvs in #1968
Remove +x from install scripts by @carolynvs in #1967
Sync main into release/v1 by @carolynvs in #1969
Add F5 to adopters list by @carolynvs in #1970
Do not assume that all bundles have a supported porter.yaml file by @carolynvs in #1974
Use latest operator docs during netlify build by @carolynvs in #1975
Bump cnab-go, Go, docker, containerd and k8s (on stable) by @carolynvs in #1971
Bump cnab-go, cnab-to-oci, docker, containerd (on release/v1) by @carolynvs in #1973
Use Go 1.17.8 in build by @carolynvs in #1977
Fix setting GitHub action env vars by @carolynvs in #1981
Cleanup test and example bundles by @carolynvs in #1985
Rename context package to portercontext by @carolynvs in #1987
Move magefile helpers into github.com/getporter/magefiles by @carolynvs in #1983
Update to go 1.18 by @VinozzZ in #1990
Bump magefiles to fix integration tests by @carolynvs in #1991
Bump magefiles library by @carolynvs in #1993
Add GitHub action to scan our code and porter-agent image by @carolynvs in #1994
Fix duplicate error message when command fails by @carolynvs in #1995
Support stringArray cobra flag type by @carolynvs in #1998
Check manifest schemaVersion in Porter commands before executing by @carolynvs in #1997
Fix website BASEURL by @carolynvs in #2003
Support additional docker flags and remove legacy docker build driver by @carolynvs in #1999
Make runtime manifest log output debug messages by @carolynvs in #2005
Add installation.namespace template var by @Jemgoss in #2001
Skip security scan when a PR is only doc changes by @carolynvs in #2008
Fallback to amd64 on M1 when installing binaries by @carolynvs in #2010
Added reference parameter to the install command by @aguywithcode in #1896
Add probot settings configuration file by @carolynvs in #2011
Move examples into example-bundles repository by @carolynvs in #2015
Use upstream close issues github action by @carolynvs in #2022
Fix typo of close issues gh action by @carolynvs in #2023
fix edge cases in docs by @qpetraroia in #2024
Add create a bundle task documentation by @carolynvs in #2007
Save sensitive params into secret store by @VinozzZ in #1992
add documentation for storing sensitive data into secret store by @VinozzZ in #2033
Linux install script uses a symlink by @tamirkamara in #2032
[Docs] Complete sentence on "manage installation" doc by @joshuabezaleel in #2028
increment installation schema version by @VinozzZ in #2036
Fix file name misspell on pkg/cnab/parameter_sources_test.go by @joshuabezaleel in #2039
[Docs] Add key config param flag for object parameter and escape string for double dash flag by @joshuabezaleel in #2030
Fix nil panic in integration test by @VinozzZ in #2042
Add mixin version when building the bundle by @joshuabezaleel in #1952
Enable setting custom values during porter build. by @joshuabezaleel in #1900
add quickstart doc for porter configuration file by @VinozzZ in #2038
Instrument plugins by @carolynvs in #2026
Switch from StringSlice to StringArray by @Simpcyclassy in #1931
Gracefully handle non-string custom values by @carolynvs in #2043
Backport Switch from StringSlice to StringArray (#1931) by @carolynvs in #2046
Revert "Use a symlink in a linux install" by @carolynvs in #2049
Bump cnab-go to v0.23.2 by @carolynvs in #2054
Consolidate storage-related packages into pkg/storage by @carolynvs in #2052
pkg/storage: add dash when formating sensitive data's key by @VinozzZ in #2056
Fix enabling telemetry by @carolynvs in #2061
pkg/storage: fix connection leak by @VinozzZ in #2060
Rename claims to installations by @carolynvs in #2053
Handle error when resolving config file secrets by @carolynvs in #2069
Do not load config for the bash completion command by @carolynvs in #2070
Fix plugin load recursion by @carolynvs in #2071
Add documentation for Create Porter's Configuration file under Task by @VinozzZ in #2045
Bump secrets plugin protocol version to 2 by @carolynvs in #2077
Pin v0.38 install script to compatible package versions by @carolynvs in #2076
Fix plugin tracing again 😭 by @carolynvs in #2073
Fix context passed when resolving secrets in config file by @carolynvs in #2068
Support the interrupt signal SIGINT by @carolynvs in #2078
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
Do not print "tools used" section on explain by @joshuabezaleel in #2088
Fix bson.D conversion in GRPC by @VinozzZ in #2083
Update plugins overview by @carolynvs in #2092
Edit index.md for Typo by @hrittikhere in #2094
update azure plugins documentation by @VinozzZ in #2064
Add GitLab to Registries by @hrittikhere in #2098
Support tracing the smoke and integration tests by @carolynvs in #2058
Include the schema versions in migration errors by @carolynvs in #2103
Remove the github settings bot by @carolynvs in #2106
Sync from main by @carolynvs in #2101
update kubernetes-plugins doc by @VinozzZ in #2104
Update hashicorp plugin page with temp fork by @carolynvs in #2108
Do not include plugin config in error by @carolynvs in #2105
Fix performance for porter list by @carolynvs in #2096
Remove unneeded ToLower by @tchaudhry91 in #2112
Add registry.ListTags by @carolynvs in #2109
Cleanup build-driver config setting by @carolynvs in #2114
Show all blog posts on the blog page by @carolynvs in #2115
Refactor the bundle adapter by @carolynvs in #2110
Fix log messages from mongodb-docker by @carolynvs in #2116
Sync release/v1 with main by @carolynvs in #2118
Remove structured logs exp flag by @carolynvs in #2113
add blog post for the new secret plugin protocol by @VinozzZ in #2121
Remove group from StorageProtocol.FindOptions by @carolynvs in #2120
change dependency schema in porter by @VinozzZ in #2117
Fix race condition in plugin logs routine by @carolynvs in #2126
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
Increase plugin start/stop timeouts by @carolynvs in #2139
Add InstallationStore.FindInstallations by @carolynvs in #2119
Rename DisplayRun.ClaimID to ID by @carolynvs in #2138
Support Docker TLS environment variables by @carolynvs in #2134
Add vet and lint targets to magefile by @tchaudhry91 in #2141
Fix build target on an arm dev machine by @carolynvs in #2144
Storage fix-permissions should handle missing config by @carolynvs in #2145
Use user specified directory for resolving file path by @VinozzZ in #2142
Update to helm3 mixin v0.1.16 by @carolynvs in #2148
Fix two small typos in docs by @kevinbarbour in #2155
Sanitize archive folder name by @VinozzZ in #2154
Adding pagination for installation, parameter, and credential list result using skip and limit option by @joshuabezaleel in #2137
fix archive folder test for by @VinozzZ in #2160
Fix Vet Errors by @tchaudhry91 in #2153
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
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
Use v1 contributing info on main porter site by @carolynvs in #2173
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
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
Blog: New template delimiter by @carolynvs in #2260
Update install page with latest 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
read image pull response to save image to local cache by @VinozzZ in #2282
Link to v0.getporter.org for older docs by @carolynvs in #2289
replace bundle.invocationImage with bundle.installerImage by @VinozzZ in #2283
pin invocation image to linux/amd64 by @VinozzZ in #2286
persist run record for custom actions that produce outputs by @VinozzZ in #2291
add docs for release process by @VinozzZ in #2285
Notes for windows agent configuration by @carolynvs in #2295
Update branch instructions in contributing guide by @carolynvs in #2294
Fix support for insecure registries by @carolynvs in #2273
Use go 1.18.5 on netlify by @carolynvs in #2304
Added unexpected EOF error check for when state file exists but is empty by @sgettys in #2306
Fix typo on mongodb plugin page by @carolynvs in #2314
Use caching in the CI pipeline by @carolynvs in #2308
Support plain http registries that are not localhost/127.x.x.x by @carolynvs in #2301
Simplify name of dependency structs on the manifest by @carolynvs in #2322
Sort list of images when archiving by @jarnfast in #2326
Fix typo in credentials quickstart by @carolynvs in #2327
Retrieve mixin configuration schema from mixins by @carolynvs in #2290
Document how to do a clean install by @carolynvs in #2330
Remove flakey test TestPlugins_CatchStderr by @carolynvs in #2332
Fix unxpected size error when publishing bundle by @carolynvs in #2321
Discard the temporary invocation image tag during publish by @carolynvs in #2328
Disable windows smoke tests by @carolynvs in #2335
Recommend combination of create and apply commands instead of generate for docs by @joshuabezaleel in #2302
Document how to use cosmos with the mongodb plugin by @carolynvs in #2340
Make identifiable temporary bundle image tags by @carolynvs in #2336
Force push bundles by @carolynvs in #2331
Add bdegetter and sgettys as maintainers 🎉 by @carolynvs in #2346
Update install instructions to use 1.0.0-rc.1 by @carolynvs in #2347
Clarify in docs that schemaType isn't supported on porter.yaml by @carolynvs in #2349
Correct state when uninstalling and (re-)installing bundles by @jarnfast in #2354
Don't copy textmixin into PORTER_HOME by @carolynvs in #2359
Document how to upgrade a bundle using digest by @VinozzZ in #2352
Set runtime debug mode by @carolynvs in #2360
Do not print out creds/params before running the bundle by @carolynvs in #2362
Pass docker auth when retrieving bundle metadata by @carolynvs in #2366
Bump github.com/ulikunitz/xz for CVE-2020-16845 (release candidate) by @carolynvs in #2368
Log in to docker in release build by @carolynvs in #2369
Update install instructions to use 1.0.0-rc.2 by @carolynvs in #2370
Update installation instructions for mixins by @carolynvs in #2371
stop using unsupported debug flag for plugins by @VinozzZ in #2377
Replace associated credential sets when running bundle by @carolynvs in #2373

New Contributors

@fibonacci1729 made their first contribution in #1731
@adnxn made their first contribution in #1792
@f1rstmehul made their first contribution in #1810
@avinashupadhya99 made their first contribution in #1834
@anjayajodha made their first contribution in #1815
@mikebarkas made their first contribution in #1842
@mahendrabishnoi2 made their first contribution in #1855
@VinozzZ made their first contribution in #1863
@devigned made their first contribution in #1919
@sakkshm26 made their first contribution in #1915
@aguywithcode made their first contribution in #1896
@qpetraroia made their first contribution in #2024
@tamirkamara made their first contribution in #2032
@Simpcyclassy made their first contribution in #1931
@hrittikhere made their first contribution in #2094
@tchaudhry91 made their first contribution in #2112
@kevinbarbour made their first contribution in #2155
@sgettys made their first contribution in #2165
@epsxy made their first contribution in #2175
@reveurguy made their first contribution in #2178
@jasmdk made their first contribution in #2259
@jarnfast made their first contribution in #2326

Full Changelog: v0.38.5...v1.0.0