Comment publier des applications - AWS Serverless Application Repository
Publication d'une application (AWS CLI)Publication d'une nouvelle application (console)Suppression d'une applicationAnnuler le partage d'une applicationSuppression d'une application

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment publier des applications

Cette section fournit des procédures de publication de votre application sans serveur vers AWS Serverless Application Repository à l'aide de l'interface de ligne de commande AWS SAM ou de l'AWS Management Console. Elle vous montre également comment partager votre application pour permettre à d'autres utilisateurs de la déployer et à la supprimer de AWS Serverless Application Repository.

Important

Les informations que vous entrez lorsque vous publiez une application ne sont pas chiffrées. Ces informations comprennent des données telles que le nom de l'auteur. Si vous disposez d'informations personnelles identifiables que vous ne souhaitez pas stocker ou rendre publiques, nous vous recommandons de ne pas les saisir lors de la publication de votre application.

Publication d'une application (AWS CLI)

La façon la plus simple de publier une application sur AWS Serverless Application Repository consiste à utiliser un ensemble de commandes d'interface de ligne de commande AWS SAM. Pour de plus amples informations, veuillez consulter Publication d'une application à l'aide de l'interface de ligne de commande AWS SAM dans le Guide du développeur AWS Serverless Application Model (AWS SAM).

Publication d'une nouvelle application (console)

Cette section vous montre comment utiliser l'AWS Management Console pour publier une nouvelle application dans AWS Serverless Application Repository. Pour obtenir des instructions sur la publication d'une nouvelle version d'une application existante, veuillez consulter Publication d'une nouvelle version d'une application existante.

Prérequis

Avant de publier une application sur AWS Serverless Application Repository, vous avez besoin des éléments suivants :

  • Une validitéAWS.

  • Une validitéAWS Serverless Application Model(AWS SAM) qui définit le modèleAWSressources qui sont utilisées. Pour de plus amples informations sur les modèles AWS SAM, veuillez consulter Concepts de base des modèles AWS SAM.

  • Un package pour votre application que vous avez créé à l'aide de la commande AWS CloudFormation package pour l'AWS CLI. Cette commande empaquette les artefacts locaux (chemins locaux) auxquels votre modèle AWS SAM fait référence. Pour plus d'informations, consultez package dans la documentation AWS CloudFormation.

  • Une URL qui pointe vers le code source de votre application, si vous souhaitez publier votre application publiquement.

  • Un fichier readme.txt. Ce fichier doit décrire comment les clients peuvent utiliser votre application et comment la configurer avant de la déployer dans leur propre application et comment la configurer.AWScomptes.

  • Un fichier license.txt ou un identifiant de licence valide du site web SPDX. Notez qu'une licence n'est requise que si vous souhaitez partager votre application publiquement. Si vous voulez garder votre application privée ou la partager uniquement en privé, vous n'avez pas besoin de spécifier de licence.

  • Une stratégie de compartiment Amazon S3 valide qui accorde les autorisations de lecture du service pour artefacts chargés sur Amazon S3 quand vous avez empaqueté votre application. Pour définir cette stratégie, procédez comme suit :

    1. Ouvrez la console Amazon S3 sur https://console.aws.amazon.com/s3/.

    2. Choisissez le compartiment Amazon S3 que vous avez utilisé pour empaqueter votre application.

    3. Choisissez l'onglet Permissions (Autorisations).

    4. Choisissez le bouton Stratégie de compartiment.

    5. Collez l'instruction de stratégie suivante dans l'éditeur de stratégie de compartiment. Veillez à remplacer le nom de votre compartiment dans le menuResourceet votreAWSID de compte dans le fichierConditionélément. L'expression de l'Conditionélément assurerAWS Serverless Application Repositoryn'est autorisé à accéder aux applications qu'à partir de l'option spécifiéeAWS. Pour plus d'informations sur les déclarations de stratégie, consultez Référence des éléments de stratégie IAM JSON dans le Guide de l'utilisateur IAM.

      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service":  "serverlessrepo.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::bucketname/*",
            "Condition" : {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

    6. Choisissez le bouton Enregistrer.

Procédure

Créez une application dans AWS Serverless Application Repository à l'aide de la procédure suivante.

Pour créer une application dans AWS Serverless Application Repository

  1. Ouvrez la console AWS Serverless Application Repository et choisissez Publish applications (Publier les applications).

  2. Sur la page Publier une application entrez les informations d'application suivantes, puis choisissez Publier une application :

    Propriété Obligatoire Description
    Application name (Nom de l'application) TRUE

    Nom de l'application .

    Longueur minimale = 1. Longueur maximale = 140.

    Modèle : [a-zA-Z0-9\-]+
    Author (Auteur) TRUE

    Nom de l'auteur qui publie l'application.

    Longueur minimale = 1. Longueur maximale = 127.

    Modèle : ^ [a-z0-9] (([a-z0-9] |- ( ? ! -)) * [a-z0-9]) ? $
    Page d'accueil FALSE Une URL contenant plus d'informations sur l'application, par exemple, l'emplacement de votre GitHub référentiel de l'application.
    Description TRUE

    Description de l'application.

    Longueur minimale = 1. Longueur maximale = 256.
    Etiquettes FALSE

    Les étiquettes qui améliorent la découverte d'applications dans les résultats de recherche.

    Longueur minimale = 1. Longueur maximale = 127. Nombre maximal d'étiquettes : 10.

    Modèle : ^[a-zA-Z0-9+\\-_:\\/@]+$
    Licence Spdx (liste déroulante) FALSE Choisissez un identificateur de licence valide dans la liste déroulante qui contient les licences disponibles sur le site web SPDX. Le choix d'un élément dans la liste déroulante remplit la zone de texte Licence située en dessous de celui-ci. Remarque : Le choix d'une licence dans la liste déroulante remplace le contenu de l'Licenceet rejette toute modification manuelle que vous avez effectuée.
    Licence FALSE

    Téléchargez un fichier de licence .txt ou choisissez une licence dans la liste déroulante de licence Spdx décrite dans la ligne précédente. Le choix d'une licence dans la liste déroulante Licence Spdx remplit automatiquement la zone de texte Licence. Vous pouvez modifier manuellement le contenu de cette zone de texte après avoir téléchargé un fichier de licence ou en avoir choisi un dans la liste déroulante Licence Spdx. Toutefois, si une autre licence Spdx est choisie dans la liste déroulante, toutes les modifications manuelles que vous avez effectuées sont supprimées.

    Il s'agit d'un champ d'option, mais vous devez fournir une licence afin de partager l'application publiquement.
    Readme FALSE

    Téléchargez le contenu du fichier Readme, qui peut être au format texte ou balisage. Ces contenus sont affichés sur la page détaillée de l'application dans le AWS Serverless Application Repository. Vous pouvez modifier manuellement le contenu de cette zone de texte après avoir téléchargé un fichier.
    Version sémantique FALSE

    Version sémantique de l'application. Pour de plus amples informations, veuillez consulter le site web Contrôle de version sémantique.

    Vous devez fournir une valeur pour cette propriété afin de rendre votre application publique.
    URL du code source FALSE Lien vers un référentiel public pour le code source de votre application.
    SAM template (Modèle SAM) TRUE

    Une validitéAWS Serverless Application Model(AWS SAM) qui définit le modèleAWSressources qui sont utilisées.

Suppression d'une application

Les applications publiées peuvent disposer d’autorisations définies dans l'une des trois catégories suivantes :

  • Privé (par défaut)— Applications qui ont été créées avec le même compte et qui n'ont pas été partagées avec d'autresAWS. Seuls les consommateurs qui partagent votreAWSsont autorisés à déployer des applications privées.

  • Partagé en privé— Applications que l'éditeur a explicitement partagées avec un ensemble spécifique deAWScomptes, ou avecAWScomptes dans unAWSOrganisation. Les consommateurs sont autorisés à déployer des applications qui ont été partagées avec leurAWScompte ouAWSOrganisation. Pour en savoir plus sur AWS Organizations, consultez le Guide de l'utilisateurAWS Organizations.

  • Partagé publiquement— Applications que l'éditeur a partagées avec tout le monde. Tous les consommateurs ont l'autorisation de déployer n'importe quelle application partagée publiquement.

Une fois que vous avez publié une application sur AWS Serverless Application Repository, elle est définie par défaut comme privée. Cette section vous montre comment partager une application en privé avec une application spécifique.AWScomptes ou unAWSOrganisez ou partagez-le publiquement avec tout le monde.

Partage d'une application via la console

Vous avez deux options pour partager votre application avec d'autres personnes : 1) Partagez-le avec desAWScomptes ou leAWScomptes au sein de votreAWSou 2) Partagez-le publiquement avec tout le monde. Pour en savoir plus sur AWS Organizations, consultez le Guide de l'utilisateurAWS Organizations.

Option 1 : Pour partager votre application avec des applications spécifiquesAWScompte (s) ou comptes au sein de votreAWSorganisation

  1. Ouvrez la console AWS Serverless Application Repository.

  2. Dans le panneau de navigation, choisissez Published Applications (Applications publiées) pour afficher la liste des applications que vous avez créées.

  3. Choisissez l'application que vous souhaitez partager.

  4. Cliquez sur l'onglet Sharing (Partager) .

  5. Dans la section Application policy statements (Déclarations de stratégie d'application), cliquez sur le bouton Create Statement (Créer une déclaration).

  6. Dans la fenêtre Statement Configuration (Configuration de la déclaration), remplissez les champs en fonction de la façon dont vous souhaitez partager votre application.

    Note

    Si vous partager avec une organisation, vous pouvez uniquement spécifier l'organisation que votreAWSest membre de. Si vous essayez de spécifier unAWSUne erreur se produit pour une organisation dont vous n'êtes pas membre.

    Pour partager votre application avec votreAWSOrganisation, vous devez reconnaître que leUnshareApplicationsera ajoutée à votre déclaration de stratégie, au cas où le partage devrait être révoqué à l'future.

  7. Choisissez le bouton Enregistrer.

Option 2 : Partager publiquement votre application avec tout le monde

  1. Ouvrez la console AWS Serverless Application Repository.

  2. Dans le panneau de navigation, choisissez Published Applications (Applications publiées) pour afficher la liste des applications que vous avez créées.

  3. Choisissez l'application que vous souhaitez partager.

  4. Cliquez sur l'onglet Sharing (Partager) .

  5. Dans la section Public Sharing (Partage public) cliquez sur le bouton Edit (Modifier) .

  6. Sous Public sharing (Partage public), choisissez le bouton radio Enabled (Activé) .

  7. Dans la zone de texte, saisissez le nom de votre application, puis cliquez sur le bouton Save (Enregistrer) .

Note

Pour partager publiquement une application, elle doit avoir à la fois définies les propriétés LicenseUrl et SemanticVersion.

Partage d'une application via l'AWS CLI

Pour partager une application à l'aide de l'AWS CLIvous accordez des autorisations à l'aide duput-application-policypour spécifier la commandeAWScompte (s) avec lequel vous souhaitez partager en tant que directeurs d'entreprise.

Pour plus d'informations sur comment partager votre application à l'aide de l'AWSCLI, consultez.AWS Serverless Application RepositoryExemples de politiques d'application.

Annuler le partage d'une application

Il existe deux options pour annuler le partage d'une application d'unAWSOrganisation :

  1. L'éditeur de l'application peut supprimer des autorisations à l'aide de la commande put-application-policy.

  2. Un utilisateur de l'compte de gestiond'unAWSL'organisation peut effectuer ununshare applicationopération sur toute application partagée avec l'organisation, même si l'application a été publiée par un utilisateur à partir d'un autre compte.

    Note

    Lorsqu'une application n'est pas partagée à partir d'unAWSOrganisation avec l'opération « annulation du partage de l'application », elle ne peut pas être partagée avecAWSOrganisation à nouveau.

    Pour en savoir plus sur AWS Organizations, consultez le Guide de l'utilisateurAWS Organizations.

Suppression des autorisations par l’éditeur

Suppression des autorisations par l’éditeur via la console

Pour annuler le partage d'une application via le moduleAWS Management Console, vous supprimez l'énoncé de stratégie qui la partage avec d'autresAWScomptes. Pour cela, procédez comme suit :

  1. Ouvrez la console AWS Serverless Application Repository.

  2. Choisissez Available Applications (Applications disponibles) dans le volet de navigation gauche.

  3. Choisissez l'application dont vous souhaitez annuler le partage.

  4. Cliquez sur l'onglet Sharing (Partager) .

  5. Dans la section Application policy statements (Déclarations de stratégie d'application), sélectionnez la déclaration de stratégie qui partage l'application avec les comptes pour lesquels vous souhaitez annuler le partage.

  6. Sélectionnez Delete (Supprimer).

  7. Un message de confirmation s'affiche. Choisissez Supprimer à nouveau.

Suppression des autorisations par l’éditeur via l’AWS CLI

Pour annuler le partage d'une application via le moduleAWS CLI, l'éditeur peut supprimer ou modifier les autorisations à l'aide de l'optionput-application-policypour rendre l'application privée ou partager avec un autre ensemble deAWScomptes.

Pour plus d'informations sur la modification des autorisations à l'aide de l'AWSCLI, consultez.AWS Serverless Application RepositoryExemples de politiques d'application.

Annulation du partage d'une application par compte de gestion

Compte de gestion qui annule le partage d'une application depuis unAWSOrganisation via la console

Pour annuler le partage d'une application d'unAWSOrganisation par le biais duAWS Management Console, un utilisateur ducompte de gestionLes fonctions des permettent d'effectuer les opérations suivantes :

  1. Ouvrez la console AWS Serverless Application Repository.

  2. Choisissez Available Applications (Applications disponibles) dans le volet de navigation gauche.

  3. Dans la tuile de l'application, choisir Unshare (Annuler le partage).

  4. Dans la zone de message d'annulation du partage, confirmez que vous souhaitez annuler le partage de l'application en saisissant l'ID de l'organisation et le nom de l'application, puis en choisissant Save (Enregistrer).

Compte de gestion qui annule le partage d'une application depuis unAWSOrganisation par le biais duAWS CLI

Pour annuler le partage d'une application d'unAWSOrganisation, un utilisateur de lacompte de gestionpeut exécuter leaws serverlessrepo unshare-applicationcommande.

La commande suivante annule le partage d'une application d'unAWSOrganisation, oùapplicationest l'Amazon Resource Name (ARN) de l'application, etID de l'organisationest leAWSID de l'organisation :

aws serverlessrepo unshare-application --application-id application-id --organization-id organization-id

Suppression d'une application

Vous pouvez supprimer des applications depuis AWS Serverless Application Repository à l'aide de l'AWS Management Console ou de l'interface de ligne de commande AWS SAM.

Suppression d'une application (console)

Pour supprimer une application publiée via l'AWS Management Console, procédez comme suit.

  1. Ouvrez la console AWS Serverless Application Repository.

  2. Pour My Applications (Mes applications), choisissez l'application que vous souhaitez supprimer.

  3. Sur la page des détails de l'application, choisissez Supprimer l'application.

  4. Choisissez Supprimer l'application pour terminer la suppression.

Suppression d'une application (AWS CLI)

Pour supprimer une application publiée à l'aide de l'AWS CLI, exécutez la commande aws serverlessrepo delete-application.

La commande suivante supprime une application, où l’application-id est le nom de ressource Amazon (ARN) de l'application :

aws serverlessrepo delete-application --application-id application-id