cli's Introduction

deployKF - Command Line Interface (CLI)

This repo contains the command line interface (CLI) for deployKF.

Install

To install the deploykf CLI, please follow the installation instructions on the deployKF website.

Usage

The simplest usage of the deploykf CLI is to run the following command:

deploykf \
  --source-version 0.1.1 \
  --values ./custom-values.yaml \
  --output-dir ./GENERATOR_OUTPUT

This command will generate deployKF manifests in the ./GENERATOR_OUTPUT directory using the v0.1.1 source version and the values specified in your ./custom-values.yaml file. Note that the --source-version flag must correspond to a tag from a deployKF release.

TIP:

The version of the CLI does NOT need to match the --source-version you are generating manifests for. If a breaking change is ever needed, the CLI will fail to generate with newer source versions, and will print message telling you to upgrade the CLI.

Container Image

We publish the deploykf CLI as a container image on the following registries:

Registry	Image	Pull Command
GitHub Container Registry	`ghcr.io/deploykf/cli`	`docker pull ghcr.io/deploykf/cli:TAG_NAME`

To use the container image, you need to mount your local filesystem into the container:

CONTAINER_IMAGE="ghcr.io/deploykf/cli:0.1.2"

docker run \
  --rm \
  --volume "$(pwd):/home/deploykf" \
  --volume "${HOME}/.deploykf:/home/deploykf/.deploykf" \
  "${CONTAINER_IMAGE}" \
    generate \
    --source-version "0.1.1" \
    --values ./sample-values.yaml \
    --output-dir ./GENERATOR_OUTPUT

Development

Here are some helpful commands when developing the CLI:

make build: Builds the binary for your local platform and outputs it to ./bin/deploykf.
make install: Installs the binary to /usr/local/bin.
make lint: Runs golangci-lint against the codebase to check for errors.
make lint-fix: Attempts to automatically fix any linting errors found.

cli's People

Contributors

Stargazers

Watchers

cli's Issues

Add support for a homebrew formula

Checks

I have searched the existing issues.

Motivation

I would like to try deploykf using a binary install that is directly on my laptop.

Implementation

I think go releaser supports having new homebrew formulas https://docs.brew.sh/Formula-Cookbook

Are you willing & able to help?

I am able to submit a PR!
I can help test the feature!

arch mismatch in doc

Checks

I have searched the existing issues.

deployKF CLI Version

0.1.0

Description

Hi. Thanks for an interesting project!

The doc uses uname -m to figure out the target arch on Linux.

DKF_CLI_VERSION="0.1.0"
DKF_CLI_ARCH="$(uname -m)"
DFK_CLI_DEST=/usr/local/bin/deploykf

# download the binary
sudo curl -L "https://github.com/deploykf/cli/releases/download/v${DKF_CLI_VERSION}/deploykf-linux-${DKF_CLI_ARCH}" -o "${DFK_CLI_DEST}"

# make the binary executable
sudo chmod +x "${DFK_CLI_DEST}"

# test the binary
deploykf version

However, in our machine (Lambda Labs Cloud 8x A100 40GB machine), uname -m reports x86_64, whereas the release assumes amd64.

So, just copying and paste the above code downloads an empty file without an error, and deploykf version executes the empty file and prints /usr/local/bin/deploykf: 1: Not: not found

Here are my suggestions: