Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Feature: Enable use of semantic exit codes for adapted PSDSC resources

Abierto
  • ¿Algo no está bien?
#1,380 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
powershell, rust
Área
devops, tooling

Línea de trabajo

Comienza con lib/dsc-lib/src/dscresources/adapted_resource_manifest.rs y RFC0001/PR #1319 para rastrear cómo representan actualmente los recursos adaptados los códigos de salida. Define el contrato de clase y manifiesto para los códigos semánticos, incluido el comportamiento predeterminado de 0/1, y verifica que las operaciones de recursos puedan exponer un código de fallo específico.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Issue-Enhancement
Summary of the new feature / enhancement

As a resource author implementing DSC resources as PowerShell classes,
I want to be able to provide semantic exit codes for my users,
so that my resources can fit into the semantics of DSC more correctly.

Currently, adapted PSDSC resources always return an exit code of 1 for an operational failure. There is no way for a resource implemented as a PowerShell class to:

  1. Indicate a set of exit codes and their meaning for DSC from the class implementation.
  2. Indicate a set of exit codes and their meaning for DSC from the adapted resource manifest.
  3. Surface that the operation is a failure and should exit with a specific code from any given resource operation.

[!NOTE]
This problem affects other adapters as well, but we only have the PowerShell adapters published.

Proposed technical implementation details (optional)

We should add an exitCodes field to the adapted resource manifest to ensure that adapted resources can propagate semantically defined exit codes to DSC and higher order tools.

I can address the specifics of how to retrieve the exit codes from a class definition in RFC0001, but I think we need a way to properly indicate a semantic exit code from within a class method. I can't see an immediately obvious way to do this without either providing a [DscOperationException] class or requiring the resource author to implement a custom exception that includes both an exit code and message that their resource class throws.

When an adapted resource doesn't provide semantic exit codes, we should treat the exit codes the same way we do for other resources (0 for success, 1 for failure). This is an opt-in enhancement for all resources, but currently adapted resource authors can't participate in these semantics.

Lenguaje dominante
Rust
Estrellas
532
Forks
76
Merge medio
2 d 10 h
PR fusionados (30 d)
15

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de PowerShell/DSC

Todos los issues de PowerShell/DSC

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.