Auditer l'usage d'un package Pulumi sur tous vos stacks

package-usage

Par pulumi · agent-skills

Identifiez quelles stacks d'une organisation Pulumi utilisent un package spécifique et à quelles versions. Utile pour les audits cross-stack, la détection de versions de packages obsolètes ou non maintenues sur de nombreuses stacks, la recherche des stacks affectées avant la publication de changements cassants dans un package de composant, ou la planification de déploiements de mise à niveau coordonnés. N'utilisez PAS cette skill pour mettre à niveau un package de fournisseur cloud (pulumi-aws, pulumi-azure-native, pulumi-gcp, pulumi-kubernetes, etc.) dans un seul projet — utilisez plutôt la skill `provider-upgrade`. N'utilisez PAS cette skill pour la création d'infrastructure générale, le provisionnement de ressources, ou des questions pratiques sur un package.

Référence API

Récupérer la dernière version d'un package

GET /api/registry/packages?name={package_name}&orgLogin={orgName}

Vous devez inclure le paramètre orgLogin avec le nom de l'organisation de l'utilisateur. La réponse contient un tableau packages. Chaque entrée possède un champ version (la dernière version), plus name, publisher, source, et packageStatus.

Récupérer l'utilisation d'un package dans les stacks

GET /api/orgs/{orgName}/packages/usage?packageName={package_name}

Remplacez {orgName} par le nom de l'org du contexte, PULUMI_ORG, ou demandez à l'utilisateur.

Champs de la réponse :

packageName : Le package interrogé
stacks : Tableau de {stackName, projectName, version, lastUpdate}
totalStacks : Nombre total

Workflow : Trouver les stacks obsolètes

À utiliser quand l'utilisateur veut savoir quels stacks utilisent une version obsolète d'un package.

Récupérer la dernière version du package
Récupérer l'utilisation du package dans les stacks
Comparer la version de chaque stack par rapport à la dernière pour identifier les stacks obsolètes
Présenter les résultats en utilisant le format de sortie ci-dessous

Format de sortie

Présentez les résultats sous forme de tableau markdown suivi d'une ligne de résumé :

| Project | Stack | Current Version | Latest Version | Status |
|---------|-------|-----------------|----------------|--------|
| my-app  | dev   | 6.40.0          | 6.52.0         | Outdated |
| my-app  | prod  | 6.52.0          | 6.52.0         | Up-to-date |

2 of 2 stacks checked. 1 outdated.

Hors de portée : mettre à jour un stack spécifique

Cette skill identifie les stacks obsolètes. Elle n'effectue pas la mise à jour elle-même. Pour vraiment mettre à jour une version de package dans un projet — éditer package.json, requirements.txt, pyproject.toml, go.mod, ou Pulumi.yaml, exécuter pulumi preview, et réconcilier le diff — déléguez à la skill provider-upgrade.