porch/v0.0.5

Add Book Section on Authoring (#3138)

v1.0.0-beta.15

⚠ BREAKING CHANGES

• The kpt fn commands now includes Kptfile and functionConfig in the function input by default. Previously this behavior was controlled using --enable-meta-resources command-line flag. --enable-meta-resources flag is also deprecated.
  if this disrupts any of your config workflow. You can use exclude functionality to exclude resources from function inputs. This functionality was added in this release to minimize the disruption.

Highlights

• The kpt website is overhauled to reflect the new scope of kpt project. New components package orchestrator, Configuration as Data UI and Config Sync are added to the project. Some highlights:
  • kpt project has a new logo now with a demo video explaining why kpt.
  • New guides featuring namespace provisioning use case using porch, UI and CLI.
  • New guides featuring patterns such as variant constructor pattern and value propagation pattern.
• Added package orchestrator (a.k.a. porch) CLI interface under alpha subgroup (kpt alpha rpkg, kpt alpha repo, kpt alpha sync).
• Added command-line flag --save to kpt fn eval to save evaluated function to package's Kptfile.
• Added capability to select resources using labelSelector and annotationSelector in kpt fn eval and kpt fn render.
• Added capability to exclude resources in kpt fn eval and kpt fn render.
• Added support for variant constructor pattern in kpt pkg init and kpt pkg get
• Added capability to execute functions in a kubernetes cluster using porch

Changelog

• 840e7a1 'make build' injects git commit as kpt version (#3085)
• 1355dab Add CreateStrategy to validate object changes. (#3090)
• 8db75c5 Add Porch Book Chapter (#3114)
• f454d9a Add README for how to use jaeger tracing (#3040)
• 7efa31b Add kpt command for package edit (#3064)
• db672f7 Add list of toolchain components to README (#3108)
• a97673b Clarify Pluggable Deployment Mechanism (#3093)
• 6694eb4 Clean up ResourceGroup with sync del (#3072)
• efab12b Cleanup Function Errors (#3034)
• 3705750 Compute Upstream Lock Ref Correctly (#3073)
• 2b2e097 Config as Data Overview (#3058)
• 6966150 FAQ overhaul (#3102)
• f6eef6f Fix duplicate drafts in package revision list (#3052)
• 44beccf Fix guide links in README (#3117)
• ab3a997 Fix reference to value for name (#3116)
• bc22abb Fix typo
• 2f9e7b1 Fix typos config-as-data design doc (#3062)
• c6bc428 Heal Comments on Package Resources Update (#3084)
• b64ceaf Include repository address in the table rendering (#3061)
• 7865b26 Let sync get and sync del use config-management-system by default (#3071)
• dcdca9c Link to fixed svg image
• 4c5d2d3 Order package revisions (#3048)
• 4c35023 Overhaul kpt concepts (#3098)
• 7aea11e Package Orchestration Design Document (#3066)
• 63a431c Publish Porch Installation and User Guide (#3110)
• 9902281 Recognize latest package revision on publishing (#3079)
• 8de8d13 Remove Temporary Upgrade Code (#3055)
• e2526c5 Remove Unused Error Results (#3033)
• b6f8d22 Rename edit command to copy (#3094)
• 3aedf4b Reorganize Porch packages (#3069)
• e367f22 Revert "Fix guide links in README (#3117)" (#3120)
• 8f0ea93 Revision to the pod evaluator cache (#3056)
• 4db5feb Support editing of packages (#3060)
• e0be85f Support server-side-apply creation of new objects (#3075)
• 82fc28e Surface failure information from pod evaluator (#3105)
• 44a50f7 Test Various Git Branches (#3057)
• 4cf59cd Test for edit package (#3063)
• 26e59d3 Try to fix site link (#3104)
• d81c260 Update CODEOWNERS with the broader team (#3099)
• 0316c3d Update README.md (#3115)
• 8163def Update VSCode Workspace (#3092)
• df9d9c7 Update doc links (#3087)
• 94da3ee Update kpt alpha command help (#3068)
• ec3ed02 Update kpt definition on landing page (#3095)
• 1797d84 Update new logo and color (#3107)
• e10e624 Update rationale.md (#3096)
• 625d44f Update roadmap (#3100)
• f695695 Update sync delete command to use repo under platkrm org (#3111)
• c61877e Update the auth flags for registering repositories (#3101)
• 39bbc89 Update what kpt is and why kpt (#3103)
• 171c39b Use Table output for kpt alpha repo get (#3054)
• 810f425 Use commit SHA for image tags by default (#3086)
• 9c47e55 Use trap to delete temporary file (#3081)
• 5a3d22b add e2e test for distroless image (#3078)
• 3205565 added namespace provising example guide (#3109)
• acf99c6 applyset: introduce abstraction over objects (#3077)
• 1272784 cherrypick kubernetes-sigs/cli-utils#582 (#3059)
• eca503c fix broken links in porch README (#3089)
• 6f1fc3e fix: save fnConfig for custom path (#3047)
• 857fd38 fixed the sidebar navigation (#3112)
• cce9fb3 higher rate limit to prevent unnecessary client-side throttling (#3067)
• 467767a kpt rpkg get uses Table list output if appropriate (#3051)
• 236b74f make wrapper server work with distroless-based images (#3070)
• 329f948 namespace provisining using UI guide (#3113)
• a804b39 only update builtin fn which refers to the previous latest version (#3088)
• d32bf9a support preloading cache in pod evaluator (#3065)
• ac87357 update kpt alpha rpkg get help (#3091)
• 37a6c40 upgrade dependencies (#3082)
• bd3c05f use 2 instances of func runners (#3053)
• 9a8998a use kpt git parsing in rpkg clone (#3080)

porch/v0.0.3

Fatalf to Errorf (#3050)

v1.0.0-beta.14

Changelog

• 5169954 Add Missing file.Close() calls (#2761)
• c0b4a02 Add alpha command group (#2820)
• c9b7522 Aggregate status in remoterootsyncset (#2826)
• 5d7d156 Few Small Cleanups (#2827)
• 9ced0ea Fix Workload Identity service-account name (#2828)
• cd75985 Fix site sidebar to also show annotation references (#2734)
• 24faa46 Force Push (#2837)
• 6e783a8 Merge Porch into main branch (#2815)
• 620b9cc Move initRepo to test (#2839)
• 84e55ff Reconnect Watch with Backoff (#2834)
• 1c9af4e Refactor install RG command (#2803)
• 30ae069 Save inventory information into resourcegroup.yaml (#2615)
• eaab63a Skip Self When Generating LICENSES (#2856)
• 7fba141 Sort Git Tree Entries Correctly (#2838)
• 9c3ce89 Start In-Cluster Git Server For e2e Tests (#2823)
• 1fa0898 Support Cloning From Private Git Repository (#2840)
• 5b5aa3e Update Porch Configs (#2821)
• 1c298ca Update cli-utils to v0.29.2 (#2860)
• d50f858 Update to cli-utils v0.29.1 (#2845)
• 4d44ab5 Update to go1.17 (#2804)
• 9bee31b Update to latest version of cli-utils (#2796)
• 9d2d9ce Upgrade kpt dependencies (#2732)
• 6525887 Upgrade kube-apiserver to v1.23.2 (#2849)
• 20c66af Use Correct function-runner Image Tag (#2850)
• 6e2c923 chore: add color to porch tests (#2847)
• 6cc2d38 chore: reset RESTMapper with MaybeResetRESTMapper (#2844)
• 7f8adf4 effective customizations chapter (#2659)
• 10868bd feat: enable STDIN apply and destroy using RG inventory (#2709)
• 58b5e35 feat: enable migrating from Kptfile & CM to resourcegroup inventories (#2705)
• 5dad3b5 make kpt binary optional in test harness (#2758)
• 3140574 porch: create simple standalone app (#2830)
• 3a6e5c5 porch: raise memory limit, also remove CPU limit (#2829)
• e0bd1ed porch: update example first deployment (#2831)
• b1747d6 store the actuation/reconcile status in the inventory object (#2819)
• 7ee57d6 tests: Fix test flake from timestamp sanitization (#2713)
• 711387e update ResourceGroup CRD (#2794)
• c5e8647 updated the version to 1.0.0-beta.13 (#2806)

v1.0.0-beta.13

Highlights:

• Fixed NotFound status reporting for deleted KCC resources (#2689)

Changelog

• a33e987 Add structs for ResourceGroup objects (#2619)
• e077c01 Correct Apache License Text (#2664)
• ef1a189 Ensure release license file exists (#2682)
• 35eb882 Fix missing colon in design doc (#2693)
• 29c0642 Update beta.12 binaries (#2655)
• 3d90e0e design doc numbering (#2657)
• 0f3db0c fix: report NotFound status for deleted KCC resources (#2689)
• e72f21e propose ownership change to facilitate PR reviews and improving kpt.dev docs (#2679)

v1.0.0-beta.12

⚠ BREAKING CHANGES

• The kpt live apply and kpt live destroy commands now waits forever for reconciliation if no timeouts are provided. This is a change from the previous version where not providing timeout values meant kpt did not wait (with some exceptions).
• The output for the events and json printers no longer include the resource-specific health information by default, but instead just includes some less verbose output about the reconcile status for each resource. Detailed health information for each resource can be included by providing the --show-status-events flag.

Highlights

• kpt live apply and kpt live destroy leverages more status information from Config Connector resources, which prevents waiting for reconciliation for resources that is reported as failed by the Config Connector controller.
• kpt pkg update will merge the pipeline section in Kptfile as an associative list with new field name which is introduced in this release, as merge key. In case name is not specified, we use image name as merge key. issue

Changelog

• fe70337 Add 2-page rationale for kpt (#2649)
• c737224 Add custom StatusReader for Config Connector resources (#2626)
• 4b4e0dc Added docs for using exec in fn render (#2642)
• fb78ab3 Change --status-events flag to --show-status-events (#2648)
• 6be0da6 Merge pipeline (#2625)
• caa8c6a Merge pipeline design doc (#2623)
• 5eb30e0 Remove printers from third_party and use cli-utils (#2627)
• 90a4278 Update beta11 (#2646)
• 67521d1 Update cli-utils to latest version (#2616)
• b63887c Update cli-utils to v0.27.0 (#2644)
• 9ee4512 Update reference docs and book for kpt live (#2645)
• 29e455c feat: always print truncated function stderr (#2639)
• bbaef48 feat: check correct docker version is installed (#2647)

v1.0.0-beta.11

Highlights

• Added exec support for running functions using kpt fn render. (docs)
• Docs to enable shell auto-complete feature.

Changelog

• 11bc9b3 Add annotation reference docs (#2636)
• 8125c67 Cobra based autocompletion (#2631)
• ebfc90c feat: Use fn patch version for cli autocomplete (#2629)
• 32bb433 fix: bash auto completion for CLI flags (#2630)
• f9ccd1a fn render supports function binary executables (#2593)
• 839fb52 update base image in Dockerfiles (#2634)
• e3057af updated installation instructions for kpt 1.0.beta.10 (#2628)

v1.0.0-beta.10

Highlights

• Default image-pull-policy for kpt fn render and kpt fn eval changed from AlwaysPull to IfNotPresent
• KCC resources are annotated with kpt annotation to attribute kpt usage

Changelog

• efade46 --image flag typo fix (#2601)
• 2be5cb3 Add cnrm annotation to merge3 (#2605)
• cce430f Add missing json annotation to KptFile (#2598)
• 575efe5 Design proposal: kpt live -- Inventory to ResourceGroup (#2576)
• 386b8e5 Fix flaky e2e test (#2622)
• ef4c91e Implement metrics annotation (#2588)
• e70cd85 Simplify and speed up "kpt live" e2e tests (#2613)
• 9e3f7f8 Update beta 9 (#2597)
• 3fb2497 Use reconcile-timeout for live apply tests (#2618)
• 241d6a9 changed default image pull policy to if-not-present (#2600)
• ac17e15 upgrade to kyaml 0.13.0+ (#2603)

Docker images

• docker pull gcr.io/kpt-dev/kpt:v1.0.0-beta.10
• docker pull gcr.io/kpt-dev/kpt-gcloud:v1.0.0-beta.10

v1.0.0-beta.9

Changes since v1.0.0-beta.7

Highlights

• Kpt update no longer requires users to check in changes before invoking kpt pkg update.
• Update accepts empty path with version.
• Check presence of function images in local cache only when relevant.
• Fixed the property names casing issue in Kptfile schema.
• Do not error while adding merge comment.

Docs

• The road map doc has been updated.
• Added a design doc template.

Changelog

676d424 Disable unwrapping to read fnconfig (#2582)
9a88ae7 Revert "update installation doc and Homebrew to use 1.0.0-beta.8 (#2578)" (#2584)
81aa585 Update design doc review process (#2594)
d61fd35 Update kpt book with depends-on annotation (#2565)
0ca2a90 Update licenses (#2583)
1ebda55 add tests to exercise modify path annotation (#2586)
ce2a3f4 fix: use KptFileKind variable instead of KptFileName for GVR (#2580)
98f0299 update installation doc and Homebrew to use 1.0.0-beta.8 (#2578)

Docker images

• docker pull gcr.io/kpt-dev/kpt:v1.0.0-beta.9
• docker pull gcr.io/kpt-dev/kpt-gcloud:v1.0.0-beta.9

v1.0.0-beta.8

Highlights

• Kpt update no longer requires users to check in changes before invoking kpt pkg update.
• Update accepts empty path with version.
• Check presence of function images in local cache only when relevant.
• Fixed the property names casing issue in Kptfile schema.
• Do not error while adding merge comment.

Docs

• The road map doc has been updated.
• Added a design doc template.

Changelog

efbff31 Add support for multiple output formats for live e2e tests (#2555)
8795691 Do not error while adding merge comment (#2564)
ed12880 Ensured that property names are lowercase in kptfile schema (#2520)
bc04a55 Remove check if repo is checked into git for update (#2569)
6bccc37 Run live e2e tests on PRs (#2553)
892bed3 Update download link to beta7 (#2556)
3b42daa Update roadmap (#2574)
a6f1ed6 Update roadmap for Q4 (#2571)
f9c1d63 Update should accept empty path with version (#2572)
d1296b9 check presence of fn image in local cache only when relevant (#2560)
8675781 design document template (#2563)
c12da42 update homebrew to v1.0.0-beta.7 (#2561)
ec02edf update kyaml and cli-utils to latest (#2523)

Docker images

• docker pull gcr.io/kpt-dev/kpt:v1.0.0-beta.8
• docker pull gcr.io/kpt-dev/kpt-gcloud:v1.0.0-beta.8