Skip to content
play

GitHub Action

carvel-setup-action

v2.0.1 Latest version

carvel-setup-action

play

carvel-setup-action

Install Carvel apps (ytt, kbld, kapp, kwt, imgpkg and vendir)

Installation

Copy and paste the following snippet into your .yml file.

              

- name: carvel-setup-action

uses: carvel-dev/setup-action@v2.0.1

Learn more about this action in carvel-dev/setup-action

Choose a version

carvel-setup-action

Build Status Release Status

A Github Action to install Carvel apps (ytt, kbld, kapp, kwt, imgpkg, vendir and kctrl).

Usage

By default, installs latest versions of ytt, kbld, kapp, kwt, imgpkg, vendir and kctrl:

steps:
- uses: carvel-dev/setup-action@v2
- run: |
    ytt version
    kbld version

carvel-setup-action uses the GitHub API to find information about latest releases. To avoid rate limits it is recommended you pass a token:

steps:
- uses: carvel-dev/setup-action@v2
  with:
    token: ${{ secrets.GITHUB_TOKEN }}
- run: |
    ytt version
    kbld version

To install only specific apps:

steps:
- uses: carvel-dev/setup-action@v2
  with:
    only: ytt, kbld
- run: |
    ytt version
    kbld version

To exclude specific apps:

steps:
- uses: carvel-dev/setup-action@v2
  with:
    exclude: kwt, vendir
- run: |
    ytt version
    kbld version

To use a specific version of an app:

steps:
- uses: carvel-dev/setup-action@v2
  with:
    only: ytt, kbld
    kbld: v0.28.0
- run: |
    ytt version
    kbld version

Node version support

Version v2 requires a Node 20 runner. If you're using older self-hosted runners, you can still use v1 for Node 16 support.

Development

See DEVELOPMENT.