Saltar al contenido principal

Configuración de Estado Deseado

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Oh My Posh soporta Configuración de Estado Deseado (DSC) para gestión declarativa de configuraciones, permitiendo despliegues automatizados y configuraciones consistentes en múltiples sistemas.

Concepto​

Oh My Posh DSC amplía el enfoque tradicional de configuración añadiendo capacidades de automatización y orquestación. En lugar de configurar manualmente tu prompt, puedes definir el estado deseado de forma declarativa y dejar que DSC asegure que tu sistema coincida con ese estado.

DSC funciona con recursos que representan diferentes aspectos de tu configuración de Oh My Posh:

  • Recurso de Configuración: Gestiona tus archivos de configuración de Oh My Posh

  • Recurso de Shell: Maneja la inicialización e integración del shell

  • Recurso de Fuentes: Rastrea las Nerd Fonts instaladas

Estos recursos pueden usarse independientemente mediante la CLI o integrarse con herramientas de orquestación como WinGet y Microsoft DSC para despliegues automatizados.

Visión general​

El soporte DSC en Oh My Posh proporciona:

  • Configuración declarativa: Define el estado deseado de tu configuración de Oh My Posh

  • Despliegue automatizado: Configura Oh My Posh como parte de flujos de trabajo de aprovisionamiento de sistemas

  • Integración de shell: Configura automáticamente la inicialización para bash, zsh, fish, PowerShell y más

  • Gestión de fuentes: Rastrea las Nerd Fonts instaladas mediante el estado de DSC

  • Soporte de orquestación: Integración con herramientas WinGet y Microsoft DSC

La funcionalidad DSC está disponible mediante la CLI oh-my-posh y puede usarse independientemente o con herramientas de orquestación.

Recursos DSC​

Oh My Posh ofrece los siguientes recursos DSC:

Recurso de Configuración​

Gestiona archivos de configuración de Oh My Posh.

Operaciones: get, set, export, schema

# Get current configuration state
oh-my-posh config dsc get

# Apply a configuration
oh-my-posh config dsc set --state '{"states":[{"source":"~/mytheme.omp.json","format":"json"}]}'

# Get configuration schema
oh-my-posh config dsc schema

Recurso de Shell​

Gestiona la inicialización e integración del shell.

Operaciones: get, set, export, schema

# Get current shell configurations
oh-my-posh init bash dsc get

# Configure shell initialization
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/mytheme.omp.json"}]}'

Recurso de Fuentes​

Rastrea Nerd Fonts instaladas mediante Oh My Posh.

Operaciones: get, export, schema

# Get installed fonts
oh-my-posh font dsc get

# Get font schema
oh-my-posh font dsc schema

Uso directo de CLI​

Puedes usar los comandos DSC directamente desde la línea de comandos para gestión de configuraciones.

Gestión de configuraciones​

Obtener estado​

Recupera el estado actual de configuración:

oh-my-posh config dsc get

Salida de ejemplo:

{
  "states": [
    {
      "format": "json",
      "source": "~/mytheme.omp.json"
    }
  ]
}

Establecer estado​

Aplica un nuevo estado de configuración:

oh-my-posh config dsc set --state '{"states":[{"source":"~/mytheme.omp.json","format":"json"}]}'

Esto crea o actualiza el archivo de configuración en la ubicación especificada con el formato proporcionado.

Esquema​

Obtén el esquema JSON para el recurso de configuración:

oh-my-posh config dsc schema

Úsalo para comprender la estructura y opciones disponibles para estados de configuración.

Gestión de integración de shell​

Bash​

Configura la inicialización de Oh My Posh para bash:

# Get current state
oh-my-posh init bash dsc get

# Set initialization
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/mytheme.omp.json"}]}'

Esto actualiza automáticamente tu .bashrc o .bash_profile con el comando de inicialización de Oh My Posh.

Zsh​

Configura la inicialización de Oh My Posh para zsh:

# Get current state
oh-my-posh init zsh dsc get

# Set initialization
oh-my-posh init zsh dsc set --state '{"states":[{"name":"zsh","command":"oh-my-posh init zsh --config ~/mytheme.omp.json"}]}'

Esto actualiza automáticamente tu .zshrc con el comando de inicialización de Oh My Posh.

PowerShell​

Configura la inicialización de Oh My Posh para PowerShell:

# Get current state
oh-my-posh init pwsh dsc get

# Set initialization
oh-my-posh init pwsh dsc set --state '{"states":[{"name":"pwsh","command":"oh-my-posh init pwsh --config ~/mytheme.omp.json"}]}'

Esto actualiza automáticamente tu perfil de PowerShell con el comando de inicialización de Oh My Posh.

Fish​

Configura la inicialización de Oh My Posh para fish:

# Get current state
oh-my-posh init fish dsc get

# Set initialization
oh-my-posh init fish dsc set --state '{"states":[{"name":"fish","command":"oh-my-posh init fish --config ~/mytheme.omp.json"}]}'

Esto actualiza automáticamente tu archivo config.fish de fish con el comando de inicialización de Oh My Posh.

Orquestación con WinGet​

La configuración de WinGet te permite instalar Oh My Posh y aplicar configuraciones en un único archivo declarativo.

Configuración básica de WinGet​

Crea un archivo de configuración para instalar y configurar Oh My Posh:

oh-my-posh-setup.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

Aplica la configuración:

winget configure oh-my-posh-setup.yaml

Configuración completa con tema e inicialización de shell​

Este ejemplo instala Oh My Posh, añade tu configuración e inicializa PowerShell:

oh-my-posh-complete.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

  - name: Add Oh My Posh configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/mytheme.omp.json
          format: json

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/mytheme.omp.json

Aplica con:

winget configure oh-my-posh-complete.yaml

Configuración multi-shell​

Inicializa múltiples shells con configuraciones diferentes:

oh-my-posh-multi-shell.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

  - name: Add work configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/work-theme.omp.json
          format: json

  - name: Add personal configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/personal-theme.omp.json
          format: json

  - name: Initialize PowerShell with work configuration
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/work-theme.omp.json

  - name: Initialize Bash with personal configuration
    type: OhMyPosh/Shell
    properties:
      states:
        - name: bash
          command: oh-my-posh init bash --config ~/personal-theme.omp.json

Orquestación con Microsoft DSC​

Microsoft DSC (dsc) ofrece capacidades multiplataforma de gestión de configuración. Oh My Posh proporciona recursos nativos de DSC que pueden usarse en documentos de configuración DSC.

Ejemplo de configuración DSC​

Crea un documento de configuración para Oh My Posh:

oh-my-posh-dsc.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Add Oh My Posh configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/mytheme.omp.json
          format: json

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/mytheme.omp.json

Aplica la configuración usando la CLI de dsc:

dsc config set --document oh-my-posh-dsc.yaml

Configuración completa con múltiples shells​

oh-my-posh-complete-dsc.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Add primary configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/primary-theme.omp.json
          format: json

  - name: Add secondary configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/secondary-theme.omp.json
          format: yaml

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/primary-theme.omp.json

  - name: Initialize Bash
    type: OhMyPosh/Shell
    properties:
      states:
        - name: bash
          command: oh-my-posh init bash --config ~/primary-theme.omp.json

  - name: Initialize Zsh
    type: OhMyPosh/Shell
    properties:
      states:
        - name: zsh
          command: oh-my-posh init zsh --config ~/secondary-theme.omp.json

Tipos de recursos​

Oh My Posh proporciona los siguientes tipos de recursos DSC:

OhMyPosh/Config​

Gestiona archivos de configuración de Oh My Posh.

Propiedades:

  • states (array): Lista de estados de configuración
    • source (string): Ruta al archivo de configuración
    • format (string): Formato del archivo (json, yaml, toml)

OhMyPosh/Shell​

Gestiona la inicialización del shell.

Propiedades:

  • states (array): Lista de configuraciones de shell
    • name (string): Nombre del shell (bash, zsh, pwsh, fish, etc.)
    • command (string): Comando de inicialización de Oh My Posh

OhMyPosh/Font​

Monitorea fuentes Nerd instaladas. Este recurso es de solo lectura y se autocompleta cuando las fuentes se instalan a través de Oh My Posh.

Gestión del estado de configuración​

El estado DSC se almacena en la caché de Oh My Posh y persiste entre sesiones. Esto permite:

  • Seguimiento de estado: Oh My Posh recuerda configuraciones establecidas mediante DSC

  • Idempotencia: Ejecutar el mismo comando DSC múltiples veces produce el mismo resultado

  • Validación de estado: Consultar el estado actual antes de realizar cambios

Uso avanzado​

Múltiples configuraciones​

Puedes gestionar varios archivos de configuración:

oh-my-posh config dsc set --state '{
  "states": [
    {"source":"~/work.omp.json","format":"json"},
    {"source":"~/personal.omp.json","format":"json"}
  ]
}'

Inicialización específica por shell​

Inicializa múltiples shells con configuraciones diferentes:

# Bash with one configuration
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/bash-theme.omp.json"}]}'

# PowerShell with another configuration
oh-my-posh init pwsh dsc set --state '{"states":[{"name":"pwsh","command":"oh-my-posh init pwsh --config ~/pwsh-theme.omp.json"}]}'

Shells compatibles​

La configuración DSC de shells admite los siguientes intérpretes:

  • bash: Configura .bashrc o .bash_profile

  • zsh: Configura .zshrc

  • fish: Configura ~/.config/fish/config.fish

  • pwsh: Configura el perfil de PowerShell ($PROFILE)

  • nu: Configura ~/.config/nushell/config.nu

  • elvish: Configura .elvish/rc.elv

  • xonsh: Configura .xonshrc

La integración con el shell realiza automáticamente:

  • Crea archivos de configuración si no existen

  • Actualiza comandos de inicialización existentes de Oh My Posh

  • Conserva la sintaxis específica de cada shell

  • Mantiene el espaciado y formato adecuados

Ver también​