Skip to main content

Once CLI Commands

Detailed reference for once-related CLI commands.

Commands​

check​

Check if once has been executed.

koncli once check <name> [flags]

Examples:

# Check execution status
koncli once check app-init

# Check in specific namespace
koncli once check app-init -n production

create​

Create a new once.

koncli once create <name> [flags]

Flags:

  • --ttl duration - Optional TTL for cleanup

Examples:

# Create once
koncli once create app-init

# With TTL
koncli once create app-init --ttl 1h

delete​

Delete a once.

koncli once delete <name>

Examples:

koncli once delete app-init

list​

List all onces.

koncli once list [flags]

Examples:

# List all
koncli once list

# With namespace
koncli once list -n production

Usage Patterns​

Database Initialization​

#!/bin/bash
ONCE_NAME="db-init"

if koncli once check $ONCE_NAME | grep -q "not been executed"; then
  echo "Running database initialization..."
  run-migrations
  echo "Initialization complete"
else
  echo "Database already initialized"
fi

One-Time Setup​

#!/bin/bash
ONCE_NAME="app-setup"

# Check if setup needed
if ! koncli once check $ONCE_NAME | grep -q "has been executed"; then
  echo "Running one-time setup..."
  setup-application
fi

# Start application
start-app

Resource Provisioning​

#!/bin/bash
ONCE_NAME="provision-resources"

koncli once create $ONCE_NAME --ttl 24h

if ! koncli once check $ONCE_NAME | grep -q "has been executed"; then
  echo "Provisioning cloud resources..."
  provision-s3-bucket
  provision-database
  echo "Provisioning complete"
fi