Merge branch 'main' into convert-porter-porter-to-actions-20230819-025002

Author: schristoff

.github/workflows/check-licenses.yaml

@@ -0,0 +1,26 @@
+name: Check licenses
+on:
+  push:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Set up Go
+        uses: actions/setup-go@v3
+        with:
+          go-version-file: go.mod
+          cache: true
+      - name: Install go-licenses
+        run: go install github.com/google/go-licenses@v1.6.0
+      - name: Check licenses
+        run: |
+          go-licenses check ./... \
+            --ignore github.com/xi2/xz,golang.org/x/sys/unix # https://github.com/xi2/xz/blob/master/LICENSE

CONTRIBUTING.md

@@ -39,7 +39,7 @@ how things will go.
 If this is your first contribution to Porter, we have a [tutorial] that walks you
 through how to setup your developer environment, make a change and test it.
 
-[tutorial]: https://getporter.org/contribute/tutorial/
+[tutorial]: https://getporter.org/docs/contribute/tutorial/
 
 ## Code of Conduct
 
@@ -87,15 +87,15 @@ When you create your first pull request, add your name to the bottom of our
 [board]: https://getporter.org/board
 [slack]: https://getporter.org/community#slack
 [roadmap]: https://getporter.org/src/README.md#roadmap
-[pep]: https://getporter.org/contribute/proposals/
+[pep]: https://getporter.org/docs/contribute/proposals/
 
 ## Which branch to use
 
 Unless the issue specifically mentions a branch, please create your feature branch from the **main** branch.
 
 For example:
 
-```
+```bash
 # Make sure you have the most recent changes to main
 git checkout main
 git pull
@@ -177,7 +177,7 @@ have the right to contribute the code you are submitting to the project.
 
 You sign-off by adding the following to your commit messages:
 
-```
+```bash
 Author: Your Name <your.name@example.com>
 Date:   Thu Feb 2 11:41:15 2018 -0800
 
@@ -191,12 +191,16 @@ be rejected by the automated DCO check.
 
 Git has a `-s` command line option to do this automatically:
 
-    git commit -s -m 'This is my commit message'
+```
+git commit -s -m 'This is my commit message'
+```
 
 If you forgot to do this and have not yet pushed your changes to the remote
 repository, you can amend your commit with the sign-off by running 
 
-    git commit --amend -s
+```
+git commit --amend -s
+```
 
 ## The life of a pull request
 
@@ -416,7 +420,7 @@ site/docs.
 
 or use only Hugo
 
-1. Download and install [Hugo 0.115.4](https://github.com/gohugoio/hugo/releases/tag/v0.115.4) extended version. 
+1. Download and install [Hugo 0.117.0](https://github.com/gohugoio/hugo/releases/tag/v0.117.0) extended version. 
 2. `cd docs`
 3. `hugo server --watch`
 
@@ -652,7 +656,7 @@ When you realize that you may need to make a breaking change, discuss it with a
 Here are some examples of breaking changes:
 
 * The schema of porter.yaml changed.
-* The schema of Porter's [file formats](https://getporter.org/reference/file-formats) changed.
+* The schema of Porter's [file formats](https://getporter.org/references/file-formats) changed.
 * The schema of Porter's [config file](https://getporter.org/configuration/#config-file) changed.
 * Flags or behavior of a CLI command changed, such as removing a flag or adding a validation that can result in a hard error, preventing the command from running.
 
@@ -680,5 +684,5 @@ Our [version strategy] explains how we version the project, when you should expe
 breaking changes in a release, and the process for the v1 release.
 
 [cdn]: https://getporter.org/src/infra/cdn.md
-[version strategy]: https://getporter.org/project/version-strategy/
+[version strategy]: https://getporter.org/references/version-strategy/
 [Custom Windows CI Agent]: https://getporter.org/src/infra/custom-windows-ci-agent.md

CONTRIBUTORS.md

@@ -9,80 +9,88 @@ pull request. If you are a contributor in other ways other than code, please
 either submit a pull request adding your name, or mention it to another maintainer
 and we will add you. **All** contributors belong here. 💯
 
-* [Carolyn Van Slyck](https://github.com/carolynvs) (Co-Creator of Porter)
-* [Jeremy Rickard](https://github.com/jeremyrickard) (Co-Creator of Porter)
-* [Vaughn Dice](https://github.com/vdice)
-* [Reddy Prasad](https://github.com/dev-drprasad)
-* [Thorsten Hans](https://github.com/ThorstenHans)
-* [Ronan Flynn-Curran](https://github.com/flynnduism)
-* [Allan Guwatudde](https://github.com/AGMETEOR)
-* [Josh Dolitsky](https://github.com/jdolitsky)
-* [Urvashi Reddy](https://github.com/youreddy)
-* [Jennifer Davis](https://github.com/iennae)
-* [Adam Reese](https://github.com/adamreese)
-* [Simon Davies](https://github.com/simongdavies)
-* [Phillip Ahereza](https://github.com/phillipahereza)
-* [Ivan Towlson](https://github.com/itowlson)
-* [Scott Coulton](https://github.com/scotty-c)
-* [Radu Matei](https://github.com/radu-matei)
-* [Raymond Kao](https://github.com/raykao)
-* [Ryan Moran](https://github.com/ryanmoran)
-* [Sean Harvey](https://github.com/halkyon)
-* [SpiLLeR](https://github.com/SpiLLeR)
-* [Weidong Feng](https://github.com/fenngwd)
-* [Y.Horie](https://github.com/u5surf)
-* [Zhaoyang Jiang](https://github.com/JiangZhaoYang)
-* [Gauri Madhok](https://github.com/gaurimadhok)
-* [Abhishek Gupta](https://github.com/abhirockzz)
-* [Anubhav Mishra](https://github.com/anubhavmishra)
-* [Aravind](https://github.com/scriptonist)
-* [Artem](https://github.com/SuddenGunter)
-* [Ben Wilkinson](https://github.com/brwilkinson)
-* [Brad](https://github.com/bradcypert)
-* [Clarence Bakirtzidis](https://github.com/clarenceb)
-* [Cory O'Daniel](https://github.com/coryodaniel)
-* [Hongchao Deng](https://github.com/hongchaodeng)
-* [John Reese](https://github.com/jpreese)
-* [Lanre Adelowo](https://github.com/adelowo)
-* [Matt Butcher](https://github.com/technosophos)
-* [Michael William Boldt](https://github.com/mboldt)
-* [Mohamed Chorfa](https://github.com/MChorfa)
-* [Don Stewart](https://github.com/donmstewart)
-* [Nicholas Carrigan](https://github.com/nhcarrigan)
-* [Stéphane Este-Gracias](https://github.com/sestegra)
-* [Jeetu Kumar](https://github.com/i-am-jeetu)
-* [Divyam Bhasin](https://github.com/divbhasin)
-* [Ritesh Yadav](https://github.com/DARK-art108)
-* [Jérémy Audiger](https://github.com/jaudiger)
-* [Om More](https://github.com/thisisommore)
-* [Avinash Upadhyaya](https://github.com/avinashupadhya99)
-* [Mike Barkas](https://github.com/mikebarkas)
-* [Joshua Bezaleel Abednego](https://github.com/joshuabezaleel)
-* [Avinash Upadhyaya](https://github.com/avinashupadhya99)
-* [Mahendra Bishnoi](https://github.com/mahendrabishnoi2)
-* [Yingrong Zhao](https://github.com/VinozzZ)
-* [Saksham Sharma](https://github.com/sakkshm26)
-* [Jeremy Goss](https://github.com/Jemgoss)
-* [Chioma Onyekpere](https://github.com/Simpcyclassy)
-* [Saksham Sharma](https://github.com/sakkshm26)
-* [Quentin Petraroia](https://github.com/qpetraroia)
-* [Tamir Kamara](https://github.com/tamirkamara)
-* [Chioma Onyekpere](https://github.com/Simpcyclassy)
-* [Hrittik Roy](https://github.com/hrittikhere)
-* [Tanmay Chaudhry](https://github.com/tchaudhry91)
-* [Priyanshu Singh](https://github.com/reveurguy)
-* [Kevin Barbour](https://github.com/kevinbarbour)
-* [Epsxy](https://github.com/epsxy)
-* [Jens Arnfast](https://github.com/jarnfast)
-* [Madhu M Pandurangi](https://github.com/MadhuMPandurangi)
-* [Karanjot Singh](https://github.com/0xquark)
-* [Omar Kohl](https://github.com/omarkohl)
-* [James Blair](https://github.com/jmhbnz)
-* [Chengwei Guo](https://github.com/cw-Guo)
-* [Sarah Christoff](https://github.com/schristoff)
-* [Aleksey Barabanov](https://github.com/alekseybb197)
-* [Sanskar Bhushan](https://github.com/sbdtu5498)
-* [Tomi Paananen](https://github.com/tompaana)
-* [Troy Connor](https://github.com/troy0820)
-* [Phill Gibson](https://github.com/phillipgibson)
-* [Ludvig Liljenberg](https://github.com/ludfjig)
+- [Carolyn Van Slyck](https://github.com/carolynvs) (Co-Creator of Porter)
+- [Jeremy Rickard](https://github.com/jeremyrickard) (Co-Creator of Porter)
+- [Vaughn Dice](https://github.com/vdice)
+- [Reddy Prasad](https://github.com/dev-drprasad)
+- [Thorsten Hans](https://github.com/ThorstenHans)
+- [Ronan Flynn-Curran](https://github.com/flynnduism)
+- [Allan Guwatudde](https://github.com/AGMETEOR)
+- [Josh Dolitsky](https://github.com/jdolitsky)
+- [Urvashi Reddy](https://github.com/youreddy)
+- [Jennifer Davis](https://github.com/iennae)
+- [Adam Reese](https://github.com/adamreese)
+- [Simon Davies](https://github.com/simongdavies)
+- [Phillip Ahereza](https://github.com/phillipahereza)
+- [Ivan Towlson](https://github.com/itowlson)
+- [Scott Coulton](https://github.com/scotty-c)
+- [Radu Matei](https://github.com/radu-matei)
+- [Raymond Kao](https://github.com/raykao)
+- [Ryan Moran](https://github.com/ryanmoran)
+- [Sean Harvey](https://github.com/halkyon)
+- [SpiLLeR](https://github.com/SpiLLeR)
+- [Weidong Feng](https://github.com/fenngwd)
+- [Y.Horie](https://github.com/u5surf)
+- [Zhaoyang Jiang](https://github.com/JiangZhaoYang)
+- [Gauri Madhok](https://github.com/gaurimadhok)
+- [Abhishek Gupta](https://github.com/abhirockzz)
+- [Anubhav Mishra](https://github.com/anubhavmishra)
+- [Aravind](https://github.com/scriptonist)
+- [Artem](https://github.com/SuddenGunter)
+- [Ben Wilkinson](https://github.com/brwilkinson)
+- [Brad](https://github.com/bradcypert)
+- [Clarence Bakirtzidis](https://github.com/clarenceb)
+- [Cory O'Daniel](https://github.com/coryodaniel)
+- [Hongchao Deng](https://github.com/hongchaodeng)
+- [John Reese](https://github.com/jpreese)
+- [Lanre Adelowo](https://github.com/adelowo)
+- [Matt Butcher](https://github.com/technosophos)
+- [Michael William Boldt](https://github.com/mboldt)
+- [Mohamed Chorfa](https://github.com/MChorfa)
+- [Don Stewart](https://github.com/donmstewart)
+- [Nicholas Carrigan](https://github.com/nhcarrigan)
+- [Stéphane Este-Gracias](https://github.com/sestegra)
+- [Jeetu Kumar](https://github.com/i-am-jeetu)
+- [Divyam Bhasin](https://github.com/divbhasin)
+- [Ritesh Yadav](https://github.com/DARK-art108)
+- [Jérémy Audiger](https://github.com/jaudiger)
+- [Om More](https://github.com/thisisommore)
+- [Avinash Upadhyaya](https://github.com/avinashupadhya99)
+- [Mike Barkas](https://github.com/mikebarkas)
+- [Joshua Bezaleel Abednego](https://github.com/joshuabezaleel)
+- [Avinash Upadhyaya](https://github.com/avinashupadhya99)
+- [Mahendra Bishnoi](https://github.com/mahendrabishnoi2)
+- [Yingrong Zhao](https://github.com/VinozzZ)
+- [Saksham Sharma](https://github.com/sakkshm26)
+- [Jeremy Goss](https://github.com/Jemgoss)
+- [Chioma Onyekpere](https://github.com/Simpcyclassy)
+- [Saksham Sharma](https://github.com/sakkshm26)
+- [Quentin Petraroia](https://github.com/qpetraroia)
+- [Tamir Kamara](https://github.com/tamirkamara)
+- [Chioma Onyekpere](https://github.com/Simpcyclassy)
+- [Hrittik Roy](https://github.com/hrittikhere)
+- [Tanmay Chaudhry](https://github.com/tchaudhry91)
+- [Priyanshu Singh](https://github.com/reveurguy)
+- [Kevin Barbour](https://github.com/kevinbarbour)
+- [Epsxy](https://github.com/epsxy)
+- [Jens Arnfast](https://github.com/jarnfast)
+- [Madhu M Pandurangi](https://github.com/MadhuMPandurangi)
+- [Karanjot Singh](https://github.com/0xquark)
+- [Omar Kohl](https://github.com/omarkohl)
+- [James Blair](https://github.com/jmhbnz)
+- [Chengwei Guo](https://github.com/cw-Guo)
+- [Sarah Christoff](https://github.com/schristoff)
+- [Aleksey Barabanov](https://github.com/alekseybb197)
+- [Sanskar Bhushan](https://github.com/sbdtu5498)
+- [Tomi Paananen](https://github.com/tompaana)
+- [Troy Connor](https://github.com/troy0820)
+- [Phill Gibson](https://github.com/phillipgibson)
+- [Ludvig Liljenberg](https://github.com/ludfjig)
+- [Maninderjit Bindra](https://github.com/manisbindra)
+- [Gonçalo Montalvão Marques](https://github.com/gonmmarques)
+- [Sumit Kumar Soni](https://github.com/zelfroster)
+- [Chaiyapruek Muangsiri](https://github.com/cmppoon)
+- [Xin Fu](https://github.com/imfing)
+- [KallyDev](https://github.com/kallydev)
+- [Salman Shah](https://github.com/sbshah97)
+- [Ray Terrill](https://github.com/rayterrill)

README.md

@@ -60,15 +60,15 @@ Plugins let you store Porter's data and retrieve secrets from an external servic
 [Open an Issue]: https://github.com/getporter/porter/issues/new/choose
 [Forum]: https://getporter.org/forum/
 [Dev Meeting]: https://getporter.org/community/#dev-meeting
-[Porter Enhancement Proposals]: https://getporter.org/contribute/proposals/
+[Porter Enhancement Proposals]: https://getporter.org/docs/contribute/proposals/
 
 # Looking for Contributors
 
 Want to work on Porter with us? 💖 We are actively seeking out new contributors
 with the hopes of building up both casual contributors and enticing some of you
 into becoming reviewers and maintainers.
 
-<p align="center">Start with our <a href="https://getporter.org/contribute/">New Contributors Guide</a>
+<p align="center">Start with our <a href="https://getporter.org/docs/contribute/">New Contributors Guide</a>
 
 Porter wouldn't be possible without our [contributors][contributors], carrying
 the load and making it better every day! 🙇‍♀️

build/testdata/bundles/mysql/porter.yaml

@@ -1,4 +1,4 @@
-schemaVersion: 1.0.0
+schemaVersion: 1.0.1
 name: mysql
 version: 0.1.4
 registry: "localhost:5000"
@@ -57,7 +57,7 @@ uninstall:
   - exec:
       command: echo
       arguments:
-        - uninstalled
+        - uninstall mysql
 
 outputs:
   - name: mysql-password

build/testdata/bundles/wordpress/porter.yaml

@@ -1,4 +1,4 @@
-schemaVersion: 1.0.0
+schemaVersion: 1.0.1
 name: wordpress
 version: 0.1.4
 registry: "localhost:5000"

build/testdata/bundles/wordpressv2/helpers.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+install() {
+  mkdir -p /cnab/app/outputs
+  echo "topsecret-blog" >> /cnab/app/outputs/wordpress-password
+}
+
+ping() {
+  echo ping
+}
+
+# Call the requested function and pass the arguments as-is
+"$@"