Registre d'extensions personnalisé

Par défaut, Kiro utilise le marketplace d'extensions IDE à https://open-vsx.org. Vous pouvez utiliser des « politiques » propres au système d'exploitation pour configurer Kiro afin d'utiliser un registre d'extensions différent; par exemple, un registre privé pour votre organisation qui contient un ensemble limité d'extensions validées.

Pour spécifier un registre d'extensions personnalisé pour Kiro IDE sur les appareils Windows, créez une politique basée sur le registre (fichiers .admx/.adml) pour définir une nouvelle entrée de registre Windows ExtensionGalleryServiceUrl pour Kiro IDE et attribuez-lui la valeur de l'URL de votre registre d'extensions. Pour plus d'information sur les politiques basées sur le registre Windows, consultez la documentation de Microsoft.

Voici des exemples minimaux de fichiers .admx et .adml qui définissent une nouvelle entrée de registre pour les extensions de Kiro IDE. D'abord, assurez-vous d'avoir des privilèges administratifs sur votre PC de test. Enregistrez le contenu du premier extrait XML ci-dessous dans C:\Windows\PolicyDefinitions\Kiro.admx, et le contenu du deuxième dans C:\Windows\PolicyDefinitions\en-US\Kiro.adml.

Ensuite, ouvrez l'Éditeur de politique de groupe locale en ouvrant la boîte de dialogue Exécuter (Windows+R), en tapant gpedit.msc, puis en appuyant sur Entrée. Allez à Configuration ordinateur > Modèles d'administration > Kiro > Extensions. Double-cliquez sur le paramètre « ExtensionGalleryServiceUrl », sélectionnez « Activé », puis sous « Options », définissez la valeur de « ExtensionGalleryServiceUrl » à l'URL de votre registre privé. Cliquez sur Ok pour fermer la boîte de dialogue, puis fermez l'éditeur de politique.

Redémarrez Kiro pour confirmer qu'il utilise maintenant votre registre d'extensions privé. Une fois la vérification effectuée, utilisez une solution MDM ou un profil de politique de groupe AD pour le déployer à grande échelle sur tous vos appareils Windows.

Exemple de Kiro.admx :

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitions revision="1.1" schemaVersion="1.0">
  <policyNamespaces>
    <target prefix="Kiro" namespace="AWS.Policies.Kiro" />
  </policyNamespaces>
  <resources minRequiredRevision="1.0" />
  <supportedOn>
    <definitions>
      <definition name="Supported_0_11_133" displayName="$(string.Supported_0_11_133)" />
    </definitions>
  </supportedOn>
  <categories>
    <category displayName="$(string.Application)" name="Application" />
    <category displayName="$(string.Category_extensionsConfigurationTitle)" name="extensionsConfigurationTitle"><parentCategory ref="Application" /></category>
  </categories>
  <policies>
    <policy name="ExtensionGalleryServiceUrl" class="Both" displayName="$(string.ExtensionGalleryServiceUrl)" explainText="$(string.ExtensionGalleryServiceUrl_extensions_gallery_serviceUrl)" key="Software\Policies\Microsoft\Kiro" presentation="$(presentation.ExtensionGalleryServiceUrl)">
      <parentCategory ref="extensionsConfigurationTitle" />
      <supportedOn ref="Supported_0_11_133" />
      <elements>
        <text id="ExtensionGalleryServiceUrl" valueName="ExtensionGalleryServiceUrl" required="true" />
      </elements>
    </policy>
  </policies>
</policyDefinitions>

Exemple de Kiro.adml :

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitionResources revision="1.0" schemaVersion="1.0">
  <displayName />
  <description />
  <resources>
    <stringTable>
      <string id="Application">Kiro</string>
      <string id="Supported_0_11_133">Kiro &gt;= 0.11.133</string>
      <string id="Category_extensionsConfigurationTitle">Extensions</string>
      <string id="ExtensionGalleryServiceUrl">ExtensionGalleryServiceUrl</string>
      <string id="ExtensionGalleryServiceUrl_extensions_gallery_serviceUrl">Custom extension marketplace URL</string>
    </stringTable>
    <presentationTable>
      <presentation id="ExtensionGalleryServiceUrl">
        <textBox refId="ExtensionGalleryServiceUrl"><label>ExtensionGalleryServiceUrl:</label></textBox>
      </presentation>
    </presentationTable>
  </resources>
</policyDefinitionResources>

Pour spécifier un registre d'extensions personnalisé pour Kiro IDE sur les appareils macOS, créez un profil de configuration (fichier .mobileconfig) avec la propriété ExtensionGalleryServiceUrl pointant vers l'URL de votre registre, puis déployez ce profil sur tous vos appareils macOS via une solution MDM. Pour plus d'information sur les profils de configuration macOS, consultez la documentation d'Apple.

Voici un exemple minimal de fichier .mobileconfig qui configure Kiro IDE pour pointer vers un registre personnalisé. Pour utiliser cet exemple, créez un fichier sur le disque, par exemple, kiro.mobileconfig, avec ce contenu, en remplaçant les UUID d'espace réservé dans les deux entrées PayloadUUID et la deuxième entrée PayloadIdentifier par des UUID uniques, et l'URL d'espace réservé pour ExtensionGalleryServiceUrl par l'URL de votre registre privé. Ajustez toute autre propriété selon vos besoins.

Ensuite, ouvrez Réglages Système, accédez à Général > Gestion des appareils, puis glissez-déposez le fichier kiro.mobileconfig sur cet écran pour l'installer.

Redémarrez Kiro pour confirmer qu'il utilise maintenant votre registre d'extensions privé. Une fois la vérification effectuée, utilisez votre solution MDM pour le déployer à grande échelle sur tous vos appareils macOS.

Exemple de kiro.mobileconfig :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadDisplayName</key>
    <string>Kiro Configuration Profile</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
    <key>PayloadIdentifier</key>
    <string>dev.kiro.desktop</string>
    <key>PayloadUUID</key>
    <string>12345678-1234-1234-1234-123456789012</string>
    <key>PayloadContent</key>
    <array>
      <dict>
        <key>PayloadDisplayName</key>
        <string>Kiro</string>
        <key>PayloadType</key>
        <string>dev.kiro.desktop</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
        <key>PayloadIdentifier</key>
        <string>dev.kiro.desktop.12345678-1234-1234-1234-123456789012</string>
        <key>PayloadUUID</key>
        <string>12345678-1234-1234-1234-123456789012</string>
        <key>ExtensionGalleryServiceUrl</key>
        <string>https://registry.example.com/extensions</string>
      </dict>
    </array>
</dict>
</plist>

Pour spécifier un registre d'extensions personnalisé pour Kiro IDE sur les appareils Linux, créez une politique (fichier policy.json) avec la propriété ExtensionGalleryServiceUrl pointant vers l'URL de votre registre, puis déployez cette politique sur tous vos appareils Linux via une solution MDM.

Voici un fichier policy.json minimal qui configure Kiro IDE pour pointer vers un registre personnalisé. Pour utiliser cet exemple, enregistrez le contenu ci-dessous dans /etc/kiro/policy.json, en remplaçant l'URL d'espace réservé par l'URL de votre registre privé.

Redémarrez Kiro pour confirmer qu'il utilise maintenant votre registre d'extensions privé. Une fois la vérification effectuée, utilisez votre solution MDM pour le déployer à grande échelle sur tous vos appareils Linux.

Exemple de policy.json :

{
  "ExtensionGalleryServiceUrl": "https://registry.example.com/extensions"
}