kwctl CLI

annotate — Adiciona metadados Admission Controller a um módulo WebAssembly

bench — Avalia uma política Admission Controller

completions — Gera autocompletação para o shell

digest — Busca o digest do manifesto OCI de uma política

docs — Gera a documentação em markdown para os comandos do kwctl

info — Exibe informações do sistema

inspect — Inspeciona a política Admission Controller

load — Carrega políticas de um arquivo tar.gz

policies — Lista todas as políticas baixadas

pull — Puxa uma política Admission Controller de uma URI fornecida

push — Envia uma política Admission Controller para um registro OCI

rm — Remover uma política Admission Controller do armazenamento

run — Executa uma política Admission Controller de uma URI fornecida

save — Salva políticas em um arquivo tar.gz

scaffold — Cria um recurso ou arquivo de configuração Kubernetes

verify — Verifica uma política Admission Controller de uma URI fornecida usando Sigstore

-v, --verbose <VERBOSE> — Aumenta a verbosidade

--no-color <NO-COLOR> — Desabilita a saída colorida

<WASM-PATH> — Caminho para o módulo WebAssembly a ser anotado

-m, --metadata-path <PATH> — Arquivo contendo os metadados

-o, --output-path <PATH> — Arquivo de saída

-u, --usage-path <PATH> — Arquivo contendo as informações de uso da política

<URI_OR_SHA_PREFIX_OR_YAML_FILE> — URI da política, prefixo SHA ou arquivo YAML contendo recursos de política Admission Controller. Esquemas suportados: registry://, https://, file://. Se o esquema for omitido, file:// é assumido, com base no diretório atual.

--allow-context-aware <ALLOW-CONTEXT-AWARE> — Concede acesso aos recursos do Kubernetes definidos na seção contextAwareResources da política. Aviso: revise a lista de recursos cuidadosamente para evitar abusos. Desabilitado por padrão

--cert-email <VALUE> — E-mail esperado no certificado Fulcio

--cert-oidc-issuer <VALUE> — Emissor OIDC esperado nos certificados Fulcio

--disable-wasmtime-cache <DISABLE-WASMTIME-CACHE> — Desativa o uso do cache do wasmtime

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

--dump-results-to-disk <DUMP_RESULTS_TO_DISK> — Coloca os resultados em target/tiny-bench/label/.., se o target puder ser encontrado, para comparar execuções anteriores

-e, --execution-mode <MODE> — O runtime a ser usado para executar esta política
Valores possíveis: opa, gatekeeper, kubewarden, wasi

--github-owner <VALUE> — Proprietário do GitHub esperado nos certificados gerados em pipelines de CD

--github-repo <VALUE> — Repositório do GitHub esperado nos certificados gerados em pipelines de CD

--measurement-time <SECONDS> — Quanto tempo o benchmark 'deve' rodar, num_samples é priorizado, então o benchmark levará mais tempo para coletar num_samples se o código a ser avaliado for mais lento do que este limite de tempo permitido

--num-resamples <NUM> — Quantas reamostragens devem ser feitas

--num-samples <NUM> — Quantas reamostragens devem ser feitas. Recomendado pelo menos 50, acima de 100 não parece gerar um resultado significativamente diferente

--raw <RAW> — Validar uma solicitação bruta
Valor padrão: false

--record-host-capabilities-interactions <FILE> — Registrar todas as comunicações de políticas e capacidades do host no arquivo fornecido. Útil para ser combinado mais tarde com a flag '--replay-host-capabilities-interactions'

--replay-host-capabilities-interactions <FILE> — Durante as trocas de políticas e capacidades do host, o host reproduz as respostas encontradas dentro do arquivo fornecido. Isso é útil para testar políticas de maneira reproduzível, dado que nenhuma interação externa com registros OCI, DNS, Kubernetes é realizada.

-r, --request-path <PATH> — Arquivo contendo o objeto de solicitação de admissão do Kubernetes em formato JSON

--settings-json <VALUE> — String JSON contendo as configurações para esta política

-s, --settings-path <PATH> — Arquivo contendo as configurações para esta política

--sigstore-trust-config <PATH> — Arquivo formatado em JSON que conforma à mensagem ClientTrustConfig nas especificações protobuf do Sigstore. Este arquivo configura todo o estado da instância do Sigstore, incluindo os URIs usados para acessar os serviços de CA e transparência de artefatos, bem como a raiz de confiança criptográfica em si

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

-a, --verification-annotation <KEY=VALUE> — Anotação no formato chave=valor. Pode ser repetido várias vezes

--verification-config-path <PATH> — Arquivo YAML contendo informações de configuração de verificação (assinaturas, chaves públicas…​)

-k, --verification-key <PATH> — Caminho para a chave usada para verificar a política. Pode ser repetido várias vezes

--warm-up-time <SECONDS> — Quanto tempo o benchmark deve aquecer

-s, --shell <VALUE> — Tipo de shell
Valores possíveis: bash, elvish, fish, powershell, zsh

<URI> — URI da política

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

-o, --output <FILE> — Caminho onde o arquivo de documentação será armazenado

<URI_OR_SHA_PREFIX> — URI da política ou prefixo SHA. Esquemas suportados: registry://, https://, file://. Se o esquema for omitido, file:// é assumido, com base no diretório atual.

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

-o, --output <FORMAT> — Formato de saída
Valores possíveis: yaml

--show-signatures <SHOW-SIGNATURES> — Mostrar assinaturas do Sigstore

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

--input <INPUT> — Carrega políticas de um tarball

<URI> — URI da política. Esquemas suportados: registry://, https://, file://

--cert-email <VALUE> — E-mail esperado no certificado Fulcio

--cert-oidc-issuer <VALUE> — Emissor OIDC esperado nos certificados Fulcio

--docker-config-json-path <DOCKER_CONFIG> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

--github-owner <VALUE> — Proprietário do GitHub esperado nos certificados gerados em pipelines de CD

--github-repo <VALUE> — Repositório do GitHub esperado nos certificados gerados em pipelines de CD

-o, --output-path <PATH> — Arquivo de saída. Se não fornecido, será baixado para a loja Admission Controller

--sigstore-trust-config <PATH> — Arquivo formatado em JSON que conforma à mensagem ClientTrustConfig nas especificações protobuf do Sigstore. Este arquivo configura todo o estado da instância do Sigstore, incluindo os URIs usados para acessar os serviços de CA e transparência de artefatos, bem como a raiz de confiança criptográfica em si

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

-a, --verification-annotation <KEY=VALUE> — Anotação no formato chave=valor. Pode ser repetido várias vezes

--verification-config-path <PATH> — Arquivo YAML contendo informações de configuração de verificação (assinaturas, chaves públicas…​)

-k, --verification-key <PATH> — Caminho para a chave usada para verificar a política. Pode ser repetido várias vezes

<POLICY> — Política a ser enviada. Pode ser o caminho para um arquivo local, uma URI de política ou o prefixo SHA de uma política na loja.

<URI> — URI da política. Esquemas suportados: registry://

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

-f, --force <FORCE> — Enviar também uma política que não está anotada

-o, --output <PATH> — Formato de saída
Valor padrão: text
Valores possíveis: text, json

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

<URI_OR_SHA_PREFIX> — URI da política ou prefixo SHA

<URI_OR_SHA_PREFIX_OR_YAML_FILE> — URI da política, prefixo SHA ou arquivo YAML contendo recursos de política Admission Controller. Esquemas suportados: registry://, https://, file://. Se o esquema for omitido, file:// é assumido, enraizado no diretório atual.

--allow-context-aware <ALLOW-CONTEXT-AWARE> — Concede acesso aos recursos do Kubernetes definidos na seção contextAwareResources da política. Aviso: revise a lista de recursos cuidadosamente para evitar abusos. Desabilitado por padrão

--cert-email <VALUE> — E-mail esperado no certificado Fulcio

--cert-oidc-issuer <VALUE> — Emissor OIDC esperado nos certificados Fulcio

--disable-wasmtime-cache <DISABLE-WASMTIME-CACHE> — Desativar o uso do cache do wasmtime

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

-e, --execution-mode <MODE> — O runtime a ser usado para executar esta política
Valores possíveis: opa, gatekeeper, kubewarden, wasi

--github-owner <VALUE> — Proprietário do GitHub esperado nos certificados gerados em pipelines de CD

--github-repo <VALUE> — Repositório do GitHub esperado nos certificados gerados em pipelines de CD

--raw <RAW> — Validar uma solicitação bruta
Valor padrão: false

--record-host-capabilities-interactions <FILE> — Registrar todas as comunicações de políticas e capacidades do host no arquivo fornecido. Útil para ser combinado mais tarde com a flag '--replay-host-capabilities-interactions'

--replay-host-capabilities-interactions <FILE> — Durante as trocas de políticas e capacidades do host, o host reproduz as respostas encontradas dentro do arquivo fornecido. Isso é útil para testar políticas de maneira reproduzível, dado que nenhuma interação externa com repositórios OCI, DNS, Kubernetes é realizada.

-r, --request-path <PATH> — Arquivo contendo o objeto de solicitação de admissão do Kubernetes em formato JSON

--settings-json <VALUE> — String JSON contendo as configurações para esta política

-s, --settings-path <PATH> — Arquivo contendo as configurações para esta política

--sigstore-trust-config <PATH> — Arquivo formatado em JSON que conforma à mensagem ClientTrustConfig nas especificações protobuf do Sigstore. Este arquivo configura todo o estado da instância do Sigstore, incluindo os URIs usados para acessar os serviços de CA e transparência de artefatos, bem como a raiz de confiança criptográfica em si

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

-a, --verification-annotation <KEY=VALUE> — Anotação no formato chave=valor. Pode ser repetido várias vezes

--verification-config-path <PATH> — Arquivo YAML contendo informações de configuração de verificação (assinaturas, chaves públicas…​)

-k, --verification-key <PATH> — Caminho para a chave usada para verificar a política. Pode ser repetido várias vezes

<POLICIES> — lista de políticas a serem salvas

-o, --output <FILE> — caminho onde o arquivo será armazenado

admission-request — Crie um objeto AdmissionRequest

artifacthub — Gere um arquivo artifacthub-pkg.yml a partir de um arquivo metadata.yml

manifest — Gere um manifesto de recurso do Kubernetes

vap — Converter um ValidatingAdmissionPolicy do Kubernetes em um Admission Controller ClusterAdmissionPolicy

verification-config — Gerar um arquivo de configuração de verificação padrão do Sigstore

--object <PATH> — O arquivo contendo o novo objeto que está sendo admitido

--old-object <PATH> — O arquivo contendo o objeto existente

-o, --operation <TYPE> — Tipo de Recurso Customizado Admission Controller
Valores possíveis: CREATE

-m, --metadata-path <PATH> — Arquivo contendo os metadados da política

-o, --output <FILE> — Caminho onde o arquivo artifact-pkg.yml será armazenado

-q, --questions-path <PATH> — Arquivo contendo o conteúdo da interface de perguntas da política

-v, --version <VALUE> — Versão semver da política

<URI_OR_SHA_PREFIX> — URI da política ou prefixo SHA. Esquemas suportados: registry://, https://, file://. Se o esquema for omitido, file:// é assumido, com base no diretório atual.

--allow-context-aware <ALLOW-CONTEXT-AWARE> — Usa os metadados da política para definir quais recursos do Kubernetes podem ser acessados pela política. Aviso: revise a lista de recursos cuidadosamente para evitar abusos. Desabilitado por padrão

--cert-email <VALUE> — E-mail esperado no certificado Fulcio

--cert-oidc-issuer <VALUE> — Emissor OIDC esperado nos certificados Fulcio

--docker-config-json-path <DOCKER_CONFIG> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

--fulcio-cert-path <PATH> — Caminho para o certificado Fulcio. Pode ser repetido várias vezes

--github-owner <VALUE> — Proprietário do GitHub esperado nos certificados gerados em pipelines de CD

--github-repo <VALUE> — Repositório do GitHub esperado nos certificados gerados em pipelines de CD

--rekor-public-key-path <PATH> — Caminho para a chave pública do Rekor. Pode ser repetido várias vezes

--settings-json <VALUE> — String JSON contendo as configurações para esta política

-s, --settings-path <PATH> — Arquivo contendo as configurações para esta política

--sigstore-trust-config <PATH> — Arquivo formatado em JSON que conforma à mensagem ClientTrustConfig nas especificações protobuf do Sigstore. Este arquivo configura todo o estado da instância do Sigstore, incluindo os URIs usados para acessar os serviços de CA e transparência de artefatos, bem como a raiz de confiança criptográfica em si

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

--title <VALUE> — Título da política

-t, --type <VALUE> — Tipo de Recurso Customizado Admission Controller
Valores possíveis: ClusterAdmissionPolicy, AdmissionPolicy

-a, --verification-annotation <KEY=VALUE> — Anotação no formato chave=valor. Pode ser repetido várias vezes

--verification-config-path <PATH> — Arquivo YAML contendo informações de configuração de verificação (assinaturas, chaves públicas…​)

-k, --verification-key <PATH> — Caminho para a chave usada para verificar a política. Pode ser repetido várias vezes

-b, --binding <VALIDATING-ADMISSION-POLICY-BINDING.yaml> — O arquivo contendo a definição do ValidatingAdmissionPolicyBinding

--cel-policy <URI> — O módulo de política CEL a ser usado
Valor padrão: ghcr.io/kubewarden/policies/cel-policy:latest

-p, --policy <VALIDATING-ADMISSION-POLICY.yaml> — O arquivo contendo a definição da ValidatingAdmissionPolicy

<URI> — URI da política. Esquemas suportados: registry://

--cert-email <VALUE> — E-mail esperado no certificado Fulcio

--cert-oidc-issuer <VALUE> — Emissor OIDC esperado nos certificados Fulcio

--docker-config-json-path <PATH> — Caminho para um diretório contendo o arquivo 'config.json' do Docker. Pode ser usado para indicar detalhes de autenticação do registro

--github-owner <VALUE> — Proprietário do GitHub esperado nos certificados gerados em pipelines de CD

--github-repo <VALUE> — Repositório do GitHub esperado nos certificados gerados em pipelines de CD

--sigstore-trust-config <PATH> — Arquivo formatado em JSON que conforma à mensagem ClientTrustConfig nas especificações protobuf do Sigstore. Este arquivo configura todo o estado da instância do Sigstore, incluindo os URIs usados para acessar os serviços de CA e transparência de artefatos, bem como a raiz de confiança criptográfica em si

--sources-path <PATH> — Arquivo YAML contendo informações de origem (https, hosts inseguros do registro, CAs personalizadas…​)

-a, --verification-annotation <KEY=VALUE> — Anotação no formato chave=valor. Pode ser repetido várias vezes

--verification-config-path <PATH> — Arquivo YAML contendo informações de configuração de verificação (assinaturas, chaves públicas…​)

-k, --verification-key <PATH> — Caminho para a chave usada para verificar a política. Pode ser repetido várias vezes