0.0.0-dev

Remove (optional) from pull description (#2705)

3.2.0

What's Changed

New Features

• Differentiate between cluster-wide and namespaced kubeconfig generation by @kwiatekus in #2603
• Make cluster-/role binding optional when generating kubeconfig by @kwiatekus in #2605
• Support use of nullable types in flags by @Cortey in #2604
• Create alpha diagnose command by @musztardem in #2600
• Extend diagnose command by @musztardem in #2637
• Rework kyma module catalog by @FilipRudy in #2631
• Updated module add command to handle module origin by @musztardem in #2633
• Add shorthand -n for --namespace flag by @kwiatekus in #2623
• Enable machine-friendly execution of app push command by @kwiatekus in #2636
• Support custom envs for the app push command by @pPrecel in #2635
• Added command for pulling community modules by @musztardem in #2634

Documentation

• Update docs with no-alpha commands by @pPrecel in #2498
• Update docs after moving the app push command out of the alpha group by @pPrecel in #2515
• Update Kyma CLI tutorials by @grego952 in #2581
• Document --env* flags for the app push command by @pPrecel in #2638

Maintenance

• Move the portforward package to the internal level by @pPrecel in #2573
• Ignore extension commands with wrong action name by @pPrecel in #2576
• Extract generic pod operations from registry pkg by @pPrecel in #2578
• Skip arguments validation for extension subcommands by @musztardem in #2579
• Improve registry config error message by @kwiatekus in #2575
• Return error when action is not supported by @pPrecel in #2588
• Implement the call_files_to_save action by @pPrecel in #2585
• Fix resource_get name header by @pPrecel in #2591
• Describe cluster-call action by @pPrecel in #2586
• Make use of instructions defined in extensions API for function_init by @musztardem in #2596
• gomod(deps): bump istio.io/client-go from 1.27.0 to 1.27.1 by @dependabot[bot] in #2584
• gomod(deps): bump the k8s-io group with 3 updates by @dependabot[bot] in #2598
• gomod(deps): bump the docker group with 2 updates by @dependabot[bot] in #2583
• Support output message for the call_files_to_save action by @pPrecel in #2599
• Support Nullable Flags v2 by @Cortey in #2608
• Check permission prior to reading gateway by @kwiatekus in #2611
• Cover case when flag has empty (not nil) default value by @pPrecel in #2609
• Cover case when the current-context is missing by @pPrecel in #2601
• Add node usage info from metrics API to diagnostic data by @musztardem in #2610
• Fix typo by @FilipRudy in #2614
• Dont default istio-inject flag to true for app push command by @Cortey in #2618
• Update diagnose command to gather warnings from all namespaces by @musztardem in #2619
• Allow basic functions to be used by CLI Extensions by @Cortey in #2620
• gomod(deps): bump the docker group with 2 updates by @dependabot[bot] in #2630
• The app push minor fixes by @pPrecel in #2640
• strict env format by @pPrecel in #2641

Full Changelog: 3.1.2...3.2.0

3.1.2

What's Changed

Bugfixes

• Check permission prior to reading gateway (#2611) by @kwiatekus in #2612
• Cover case when the current-context is missing (#2601) by @kwiatekus in #2613

Full Changelog: 3.1.1...3.1.2

3.1.1

What's Changed

• Charry-pick: Ignore extension commands with wrong action name by @pPrecel in #2577
• cherry-pick: Skip arguments validation for extension subcommands (#2579) by @musztardem in #2582
• Cherry-pick: Return error when action is not supported (#2588) by @pPrecel in #2589
• Cherry-Pick: Fix resource get name header 3.1 by @pPrecel in #2592
• Make use of instructions defined in extensions API for function_init (#2596) by @musztardem in #2597

Full Changelog: 3.1.0...3.1.1

3.1.0

What's Changed

Highlights

• With the 3.1.0 version, you can manage the lifecycle of Kyma community modules: discovering, installing, and removing them from Kyma environments
• Command groups module, app, and commands originating from cli extensions are moved out from the alpha group

New Features

Community Modules Support:

You can now discover and add available community-driven modules:

kyma module catalog
NAME                    AVAILABLE VERSIONS                                                 COMMUNITY
...
cap-operator            0.15.0                                                             true
docker-registry         0.9.0                                                              true

kyma module add docker-registry --community --default-cr
Warning:
  You are about to install a community module.
  Community modules are not officially supported and come with no binding Service Level Agreement (SLA).
  There is no guarantee of support, maintenance, or compatibility.

Are you sure you want to proceed with the installation? [Y/n]: Y
docker-registry community module enabled

Kubeconfig Generation for selected OIDC configuration:

We have added a command to generate kubeconfig files for named openidconnects.authentication.gardener.cloud resources.

kubectl get openidconnects.authentication.gardener.cloud
NAME
oath0

kyma alpha kubeconfig generate --oidc-name oath0 --output=/tmp/oauth0.yaml
Kubeconfig saved to: /tmp/oauth0.yaml

Support for scripting and automations:

• Many commands now support the --output flag, allowing you to format command results (e.g., as YAML or JSON).
• Enhanced dry-run support lets you preview changes before applying them, improving safety and transparency.

kyma function create test --runtime nodejs22 --dry-run -oyaml > test-fn.yaml

kubectl apply -f test-fn.yaml
function.serverless.kyma-project.io/test created

Some Command Groups moved out of alpha group:

Several commands have been moved out of the alpha group as we continue with API stabilisation:
kyma module --help
kyma app push --help
kyma {extension} --help, for example kyma function --help

Bugfixes

• Added deduplication to unmanaged core modules listing by @musztardem in #2569
• Added community modules existence validation by @musztardem in #2572
• Fixed module CR calculation for unmanaged module by @musztardem in #2535

Documentation

• Document how to install stable cli by @pPrecel in #2431
• Add tip how to enable autocompletion by @kwiatekus in #2423
• Explain v3 on main readme by @kwiatekus in #2434
• Change first usage example by @kwiatekus in #2433
• Brew installation guide by @pPrecel in #2435
• Document CLI extensibility by @pPrecel in #2472
• Update OS docs based on SKR docs by @grego952 in #2489

Maintenance

• Fix stable release script by @pPrecel in #2432
• Implement actionCommands functionality by @pPrecel in #2438
• Migrate coreCommands to actionCommands by @pPrecel in #2441
• gomod(deps): bump istio.io/client-go from 1.25.0 to 1.25.1 by @dependabot[bot] in #2440
• gomod(deps): bump github.com/buildpacks/pack from 0.36.4 to 0.37.0 by @dependabot[bot] in #2430
• Bump @sap/hana-client from 2.19.20 to 2.21.31 in /tests/btp/sample-http-db-nodejs/hdi-deploy in the npm_and_yarn group across 1 directory by @dependabot[bot] in #2421
• gomod(deps): bump the k8s-io group with 3 updates by @dependabot[bot] in #2415
• Get rid of the coreCommands by @pPrecel in #2442
• Migrate CRUD templateCommands into actionCommands by @pPrecel in #2443
• gomod(deps): bump github.com/golang-jwt/jwt/v4 from 4.5.1 to 4.5.2 in the go_modules group by @dependabot[bot] in #2429
• New extensions API by @pPrecel in #2444
• Refactor kymaconfig by @pPrecel in #2446
• Purge old extensions by @pPrecel in #2445
• Refactor actions by @pPrecel in #2448
• Refactor parameters by @pPrecel in #2449
• Extensions types by @pPrecel in #2450
• New extensions functionality by @pPrecel in #2451
• Test extensions validation by @pPrecel in #2453
• Common package for extension errors by @pPrecel in #2454
• Tests for the internal/extensions/args.go file by @pPrecel in #2455
• Tests for the internal/extensions/flag.go file by @pPrecel in #2456
• Tests for the internal/extensions/commands.go file by @pPrecel in #2457
• Improve the extensions building functionality by @pPrecel in #2458
• Add tests for the errors package by @pPrecel in #2459
• Test the extensions.go file by @pPrecel in #2461
• Move the configurator to common pkg by @pPrecel in #2469
• Revert extensions config path concept by @pPrecel in #2462
• Add toArray and toEnvs functions by @pPrecel in #2470
• gomod(deps): bump istio.io/client-go from 1.25.1 to 1.25.2 by @dependabot[bot] in #2471
• gomod(deps): bump golang.org/x/net from 0.36.0 to 0.38.0 in the go_modules group by @dependabot[bot] in #2464
• Add the toYaml function by @pPrecel in #2478
• Add extensibility tutorial by @pPrecel in #2477
• allow using token in kubeconfig generate in GH Actions by @halamix2 in #2480
• Test for generating access for trusted GH OIDC by @kwiatekus in #2484
• Implement the --output flag for the module commands group by @pPrecel in #2493
• Generate documentation by @pPrecel in #2494
• Migrate repo to commands out of the alpha group by @pPrecel in #2497
• bump linter by @anoipm in #2499
• Support the aarch64 and the amd64 architectures by @pPrecel in #2502
• Secure the pull pipeline by @pPrecel in #2503
• Installation script default dir by @pPrecel in #2504
• Include istio label in the deployment template by @kwiatekus in #2506
• gomod(deps): bump istio.io/client-go from 1.25.2 to 1.26.1 by @dependabot[bot] in #2501
• Generate private file for the registry config command by @pPrecel in #2508
• Get rid of the go-www-aithenticate-parser package by @pPrecel in #2509
• Protect filenames and ask for configmation when output dir is out of working directory by @pPrecel in #2510
• gomod(deps): bump the k8s-io group with 3 updates by @dependabot[bot] in #2476
• gomod(deps): bump github.com/cloudflare/circl from 1.6.0 to 1.6.1 in the go_modules group by @dependabot[bot] in #2512
• Update e2e tests by @pPrecel in #2517
• Add Community Module by @musztardem in #2507
• Reuse prompt package by @pPrecel in #2518
• Set value from file even when file is empty by @pPrecel in #2524
• Fix getting unserved docker registries by @FilipRudy in #2526
• Delete community modules by @musztardem in #2528
• gomod(deps): bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 in the go_modules group by @dependabot[bot] in #2525
• gomod(deps): bump istio.io/client-go from 1.26.1 to 1.26.2 by @dependabot[bot] in #2521
• gomod(deps): bump the k8s-io group with 3 updates by @dependabot[bot] in #2520
• Community modules improvements by @musztardem in #2530
• Module CR and installation status in module list command by @musztardem in #2529
• Added prompt for module deletion by @musztardem in #2531
• gomod(deps): bump github.com/jedib0t/go-pretty/v6 fro...

3.0.1

What's Changed

• Cherry-Pick: Secure the pull pipeline (#2503) by @pPrecel in #2505
• Cherry pick security tickets by @pPrecel in #2519

Full Changelog: 3.0.0...3.0.1

3.0.0

What's Changed

Highlights

We are proud to bring the first stable v3 version of Kyma CLI.
This version becomes the first milestone of redesigning Kyma CLI to match expectations (expressed via kyma-project/community#872) for it to become a tool for application developers who use kyma as their k8s-based runtime.

Many commands in the deprecated v2 version were removed in v3 as they were out of the scope of the repurposed goal of Kyma CLI.

We introduced a completely new set of commands that are more oriented on simplifying and automating the steps required in the application development process in Kyma. Those are all in the alpha command group, as their final API will need some fine-tuning after we receive more feedback.

The new feature highlights are the following:

• code-to-app capability; automates the process of getting a running app from your source code
• Hands-on interaction with those custom resources defined by Kyma and its modules (Function CR and ServiceInstance/Binding CRs as first ones. Expect more really soon)
• Enabling easy automation for some common tasks developers usually do on k8s clusters (for example, generating new access for service accounts)

Get started here 🎯

All Changes

For a complete changelog, please review the release candidates of the 3.0.0 release:
https://github.com/kyma-project/cli/releases/tag/3.0.0-rc1
https://github.com/kyma-project/cli/releases/tag/3.0.0-rc2

New Contributors

• @c-pius made their first contribution in #1971
• @janmedrek made their first contribution in #1974
• @FilipRudy made their first contribution in #2316

Full Changelog: 2.20.5...3.0.0

3.0.0-rc2

What's Changed

Documentation

• Warn kyma-project.io users about early stage of the cli by @pPrecel in #2381
• Add kyma alpha app push tutorial by @FilipRudy in #2380
• Adding the Running an Application tutorial to sidebar by @grego952 in #2383

Features

• Add possibility to download latest build by @pPrecel in #2378
• Implement the kyma version command by @pPrecel in #2384
• Implement the kubeconfig generate command by @pPrecel in #2402
• OIDC for the kubeconfig generate command by @pPrecel in #2405
• Implement flags validation by @pPrecel in #2406
• Add possibility to skip extensions fetching by @pPrecel in #2409
• Add --image-pull-secret for the app push command by @pPrecel in #2413
• Refactor the kubeconfig generate package by @pPrecel in #2408
• Implement function init command by @pPrecel in #2420
• Implement Acceptance e2e tests for BTP user journey by @kwiatekus in #2318

Bug Fixes

• Remove unnecessary config fields by @pPrecel in #2394
• Return clierror.Error on any error by @pPrecel in #2403
• Get rid of the @v3 suffix by @pPrecel in #2412
• Handle extensions duplicates with base commands by @FilipRudy in #2414
• Ignore extension error on restricted args by @pPrecel in #2422
• improve init UX by @pPrecel in #2424
• Refactor extensions handling by @FilipRudy in #2427

Full Changelog: 3.0.0-rc1...3.0.0-rc2

3.0.0-rc1

Documentation

• ed5c23d Add CLI description to the help.sap.com portal (#2370)
• 8241860 Sidebar without indents (#2379)
• f4d89f3 Improve installation instruction (#2357)
• c52e669 Fix image-import in main readme (#2328)
• 5266a3f Document Instructions how to install kyma@v3 binary (#2167)
• f085667 Document Instructions how to install kyma@v3 binary (#2162)
• 94978d0 Update readme to include v3 command execution (#2109)

Features

• 1329f8e Add the --show-extensions-error flag to root (kyma) command level (#2376)
• 01032d5 Warn about extension duplicate (#2375)
• 9afcdd6 Make the .goreleaser.yml more release oriented (#2368)
• 4cabec2 Generate flags manually (#2367)
• 012d9d5 Generate docs (#2369)
• 47f9e89 Sidebar generator (#2366)
• e1ebb81 Improve docs generator (#2363)
• 7ab54e0 Run lints and units on every PR (#2364)
• 833b566 Add workflow that verifies possibility to build cli (#2365)
• b7f9473 Introduce the .goreleaser.yml file (#2358)
• 7fb636d Unify flags and commands descriptions (#2354)
• da5ef0e The docs/user/gen-docs generator (#2355)
• 6f2ee18 Switch name flag to args for create template command (#2347)
• 31f0e0f Switch name flag to args for delete template command (#2346)
• da5bf5c Switch name flag to args for get template command (#2345)
• fe38472 Replace render table lib (#2344)
• 5f7c3e9 Rework modules list (#2343)
• a5d3a26 Design and implement the 'kyma alpha modules catalog' cmd (#2342)
• 4bbde5d Improve error messages while listing modules (#2339)
• 80b4322 Support complex slices for extensions custom flags (#2335)
• f585da9 Improve parameters (#2333)
• be2c690 Add succesful operation message after manage/unmanage (#2334)
• 4a65ea2 Add the alpha <resource> get command (#2332)
• e7fa138 Add the alpha <resource> delete command (#2321)
• 5ea93f7 remove redundant --module flag from manage & unmanage commands (#2331)
• a5f7df3 Extensions create (#2320)
• 50e5878 Set correct policy after module unmanage (#2317)
• a9ca132 kyma@v3 e2e integration test on k3d (#2311)
• 2c73dcb Refactor the resources package (#2312)
• 4bb6a8e Added manage and unmanaged commands (#2316)
• 908437e Implement possibility to mount secrets and configmaps (#2310)
• 9d16ef4 Change hint msg after module commands renaming (#2302)
• 35c6a08 add STATE column to modules list (#2272)
• 35618b0 Improve error message about missing registry (#2293)
• a4d9651 Add module disable command (#2282)
• 9e68ec3 Remove the now word from the app push command output log (#2287)
• 106ac4c Hint user about wrong docker-registry configuration (#2288)
• beaca2f Add module enable command (#2283)
• 2c669bc Print external URL of the exposed app (#2284)
• 1bcafd2 Fake RootlessDynamic client (#2281)
• 18d6e3a Enable kyma alpha app push cache (#2278)
• 28e74e0 Increase deploy limits (#2275)
• ba30d79 Support args while building from dockerfile (#2273)
• 5584083 Support basic cloud native buildpack for the kyma alpha app push command (#2270)
• 7fc7e0d Improve alpha module list command UX (#2268)
• 6cf083b Remove alpha modules run execution (#2266)
• 957c22b Implement INSTALLED and MANAGED headers for table view when listing modules (#2263)
• 13b2856 Remove old modules-related commands and code (#2265)
• cc5ffe9 List modules based on ModuleTemplates (#2261)
• 871a51e Add --expose flag to kyma app push (#2254)
• c57d9b1 Create service when pushing an application via kyma alpha app push --containerport (#2250)
• 418585e Implement image building in the kyma alpha app push command (#2249)
• 5f22f06 add istio injection flag (#2248)
• fce10c2 Add final log for the kyma alpha hana map command (#2247)
• 1a2da41 Add app push command (#2246)
• 58b0e81 pin linter action (#2245)
• 336782b Added the new Hana Map command that fulfills the new CLI requirements (#2242)
• e72df26 Guide user on how to extract extension error (#2244)
• 152753f Remove hana commands (#2237)
• f832f58 Improve extensions fetcher error handler (#2235)
• f1d9c1b Support coreCommands extensions (#2233)
• 170f21e Add command to remove modules (#2212)
• 7dd7f07 Change error from Clierror to regular in rootlessdynamic client (#2211)
• b890f4d Download module manifest and cr manually from GitHub url (#2210)
• 6a7c96e refactor the ApplySpecifiedModules func (#2207)
• 5e46d0b Alpha Add command for Kyma CLI (#2197)
• 43b8905 Implement kyma client (#2190)
• cbb07b0 Replace unstructured types (#2189)
• db58aaf Move all operations on the Kubernetes resources under the kube pkg (#2188)
• 0271dcc Do not work on unstructured Kyma CR (#2187)
• 6b69462 Replace managed with channel (#2186)
• 60738ed Use the typed kyma CR (#2185)
• 855f396 Remove whitespace prefix (#2184)
• b3e9916 simplify table view (#2181)
• 8ddc51b Add deploy and undeploy managed commands (#2165)
• c85ca53 Update DockerRegistry CR types (#2169)
• 461b3ee add test for modules managed command (#2164)
• c99b5b6 Move all methods related to model.json to a separate file (#2132)
• 66a3d8b Add transport layer that retries requests on error (#2131)
• dc07ebe Add flag --installed to command modules (#2130)
• ca0988a Add "managed" flag to "modules" command (#2129)
• 4a52544 add json parameters to provision command (#2125)
• 4aac24c Add new catalog flag (#2126)
• 4e2198a OIDC: allow retrieving kubeconfig from BTP (#2124)
• 362cd9c OIDC: allow providing whole Kubeconfig (#2123)
• 595eec8 New Kyma Access CMD v2 (#2120)
• 31fee59 Allow users to provide OIDC token explicitly (#2122)
• 87e1e51 Move kubeconfig saving/printing to a common package (#2121)
• 5cc9adf Add OIDC command (#2116)

Bug Fixes

• 8883b8d Fix nightly build link (#2377)
• cd0bd8b Fix nightly build link (#2374)
• 9a89389 Fix make_latest (#2373)
• f4df2bb Fix building issue (#2359)
• 99785db fix: module delete should work with old module templates (#2326)
• b921015 fix: don't fail getting state on not installed modules (#2304)
• cb1487e Stop failing when cluster is down (#2234)
• 2535199 fix finding latest version of module in command modules catalog (#2171)
• 9b2b984 Fix used linter action version (#2163)
• aa72a51 restore go linter job (#2146)
• 15452df Update pre-release message (#2161)
• 93ba9a6 Lint fixes (#2159)
• 72648bc Fix pre-release trigger (#2160)
• 005d99c...

2.20.5

Changelog

Bug fixes

• 2ee106b: Change deprecation notice output to stderr (#2156) (@halamix2)