Visão Geral dos Modos de Runtime

O Invowk™ oferece três formas diferentes de executar comandos, cada uma com seus próprios pontos fortes. Escolha o runtime certo para seu caso de uso.

Os Três Runtimes

Runtime	Descrição	Melhor Para
native	Shell padrão do sistema	Desenvolvimento diário, performance
virtual	Shell POSIX integrado	Scripts multiplataforma, portabilidade
container	Container Docker/Podman	Reprodutibilidade, isolamento

Comparação Rápida

cmds: [
    // Native: uses your system shell (bash, zsh, PowerShell, etc.)
    {
        name: "build native"
        implementations: [{
            script: "go build ./..."
            runtimes: [{name: "native"}]
            platforms: [{name: "linux"}, {name: "macos"}, {name: "windows"}]
        }]
    },

    // Virtual: uses built-in POSIX-compatible shell
    {
        name: "build virtual"
        implementations: [{
            script: "go build ./..."
            runtimes: [{name: "virtual"}]
            platforms: [{name: "linux"}, {name: "macos"}, {name: "windows"}]
        }]
    },

    // Container: runs inside a container
    {
        name: "build container"
        implementations: [{
            script: "go build -o /workspace/bin/app ./..."
            runtimes: [{name: "container", image: "golang:1.21"}]
            platforms: [{name: "linux"}]
        }]
    }
]

Quando Usar Cada Runtime

Runtime Native

Use native quando você quiser:

• Máxima performance
• Acesso a todas as ferramentas do sistema
• Recursos específicos do shell (bash completions, plugins do zsh)
• Integração com seu ambiente de desenvolvimento

{
    name: "build"
    implementations: [
        {
            script: "go build ./..."
            runtimes: [{name: "native"}]
            platforms: [{name: "linux"}, {name: "macos"}, {name: "windows"}]
        }
    ]
}

Runtime Virtual

Use virtual quando você quiser:

• Comportamento consistente entre plataformas
• Scripts POSIX-compatíveis que funcionam em qualquer lugar
• Sem dependência de shell externo
• Debug mais simples de scripts shell

{
    name: "build"
    implementations: [{
        script: """
            echo "Building..."
            go build -o bin/app ./...
            echo "Done!"
            """
        runtimes: [{name: "virtual"}]
        platforms: [{name: "linux"}, {name: "macos"}, {name: "windows"}]
    }]
}

Runtime Container

Use container quando você quiser:

• Builds reproduzíveis
• Ambientes isolados
• Versões específicas de ferramentas
• Execução em ambiente limpo

{
    name: "build"
    implementations: [
        {
            script: "go build -o /workspace/bin/app ./..."
            runtimes: [{
                name: "container"
                image: "golang:1.21"
            }]
            platforms: [{name: "linux"}]
        }
    ]
}

Múltiplos Runtimes Por Comando

Comandos podem suportar múltiplos runtimes. O primeiro é o padrão:

{
    name: "build"
    implementations: [{
        script: "go build ./..."
        runtimes: [
            {name: "native"},  // Default
            {name: "virtual"}, // Alternative
            {name: "container", image: "golang:1.21"}  // Reproducible
        ]
        platforms: [{name: "linux"}, {name: "macos"}, {name: "windows"}]
    }]
}

Sobrescrevendo em Tempo de Execução

# Use default (native)
invowk cmd build

# Override to virtual
invowk cmd build --invk-runtime virtual

# Override to container
invowk cmd build --invk-runtime container

Listagem de Comandos

A lista de comandos mostra runtimes disponíveis com um asterisco marcando o padrão:

Available Commands
  (* = default runtime)

From current directory:
  build - Build the project [native*, virtual, container] (linux, macos)

Fluxo de Seleção de Runtime

                    ┌──────────────────┐
                    │  invowk cmd run  │
                    └────────┬─────────┘
                             │
                    ┌────────▼─────────┐
                    │ flag --invk-runtime?  │
                    └────────┬─────────┘
                             │
              ┌──────────────┴──────────────┐
              │ Sim                         │ Não
              ▼                             ▼
    ┌─────────────────────┐    ┌─────────────────────┐
    │ Usar runtime        │    │ Usar primeiro       │
    │ especificado        │    │ runtime (padrão)    │
    └─────────────────────┘    └─────────────────────┘

Validação de Dependências

Dependências são validadas de acordo com o runtime:

Runtime	Dependências Validadas Contra
native	Shell e ferramentas do sistema host
virtual	Shell integrado com utilitários core
container	Shell e ambiente do container

Isso significa que uma dependência tools como go é verificada:

• native: O go está no PATH do host?
• virtual: O go está disponível nos built-ins do shell virtual?
• container: O go está instalado na imagem do container?

Próximos Passos

Aprofunde-se em cada runtime:

• Runtime Native - Execução no shell do sistema
• Runtime Virtual - Shell POSIX integrado
• Runtime Container - Execução em Docker/Podman