ikube

README

ikube

ikube is a command-line tool for managing Kubernetes configurations stored in Infisical. It allows you to authenticate, store, list, and delete kubeconfigs securely.

Features

• Authenticate: Authenticate with Infisical using environment variables, keyring, or manual input.
• Store Kubeconfig: Store a new kubeconfig securely in Infisical.
• List Kubeconfigs: List and select kubeconfigs stored in Infisical.
• Delete Kubeconfigs: Delete kubeconfigs stored in Infisical.
• Temporary Shell: Load kubeconfig in a temporary shell session.

Installation

There are several installation options:

• As Homebrew or Linuxbrew package
• Manual installation

After installing, the tool will be available as ikube.

Homebrew Package

You can install with Homebrew for macOS or LinuxBrew for Linux

brew install funkolab/tap/ikube

Keep up-to-date with brew upgrade ikube (or brew upgrade to upgrade everything)

Manual

• Download your corresponding release
• Install the binary somewhere in your PATH (/usr/local/bin for example)
• use it with ikube

MacOS X notes for security error

Depending on your OS settings, when installing the binary manually you must run the following command: xattr -r -d com.apple.quarantine /usr/local/bin/ikube

Usage

Command Line Flags

• -v: Enable verbose mode.
• -l: Load kubeconfig in a temporary shell.
• -d: Delete kubeconfig(s).

Environment Variables

• INFISICAL_SERVER: The server URL for Infisical (default app.infisical.com).
• INFISICAL_PROJECT_ID: The project ID for Infisical.
• INFISICAL_CLIENT_ID: The client ID for Infisical (optional).
• INFISICAL_CLIENT_SECRET: The client secret for Infisical (optional).

Examples

Authenticate and List Kubeconfigs

ikube

Store a New Kubeconfig

cat /path/to/kubeconfig | ikube

Delete Kubeconfigs

ikube -d

Load Kubeconfig in Temporary Shell

ikube -l

Development

Taskfile

This project uses Task for task management. The available tasks are defined in the Taskfile.yml.

• task build: Build the binary.
• task install: Install the binary to $GOPATH/bin.
• task test: Run tests.
• task lint: Run linter.
• task all: Run all tasks (lint, test, build).

Building From Source

1. Clone the repository:

   git clone https://github.com/funkolab/ikube.git
   cd ikube
   

2. Build the binary:

   task build
   

3. Install the binary to $GOPATH/bin:

   task install
   

Running Tests

To run the tests, use:

task test

Linting

To run the linter, use:

task lint

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Acknowledgements

• Infisical
• go-fuzzyfinder
• go-keyring
• client-go

---

For more information, please refer to the source code and documentation.