À utiliser AWS Cloud9 avec AWS SDK for Ruby - AWS SDKpour Ruby
Étape 1 : configurez votre appareil Compte AWS pour l'utiliser AWS Cloud9Étape 2 : Configuration de votre environnement AWS Cloud9 de développementÉtape 3 : configurer le AWS SDK pour RubyÉtape 4 : Téléchargez un exemple de codeÉtape 5 : Exécuter un exemple de code

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.

À utiliser AWS Cloud9 avec AWS SDK for Ruby

AWS Cloud9 est un environnement de développement intégré basé sur le Web (IDE) qui contient un ensemble d'outils que vous utilisez pour coder, créer, exécuter, tester, déboguer et publier des logiciels dans le cloud. Vous pouvez utiliser AWS Cloud9 AWS SDK for Ruby pour écrire et exécuter votre code Ruby à l'aide d'un navigateur. AWS Cloud9 inclut des outils tels qu'un éditeur de code et un terminal. Comme il AWS Cloud9 IDE est basé sur le cloud, vous pouvez travailler sur vos projets depuis votre bureau, votre domicile ou n'importe où en utilisant une machine connectée à Internet. Pour obtenir des informations générales AWS Cloud9, consultez le guide de AWS Cloud9 l'utilisateur.

Suivez ces instructions pour configurer AWS Cloud9 avec AWS SDK for Ruby :

Étape 1 : configurez votre appareil Compte AWS pour l'utiliser AWS Cloud9

Pour l'utiliser AWS Cloud9, connectez-vous à la AWS Cloud9 console depuis le AWS Management Console.

Note

Si vous utilisez AWS IAM Identity Center pour vous authentifier, vous devrez peut-être ajouter l'autorisation requise de iam:ListInstanceProfilesForRole à la politique attachée à l'utilisateur dans la IAM console.

Pour configurer une IAM entité dans votre AWS compte afin d'accéder à la AWS Cloud9 console AWS Cloud9 et de s'y connecter, consultez la section Configuration de l'équipe AWS Cloud9 dans le guide de AWS Cloud9 l'utilisateur.

Étape 2 : Configuration de votre environnement AWS Cloud9 de développement

Une fois connecté à la AWS Cloud9 console, utilisez-la pour créer un environnement de AWS Cloud9 développement. Après avoir créé l'environnement, AWS Cloud9 ouvre celui correspondant IDE à cet environnement.

Pour plus de détails, voir Création d'un environnement AWS Cloud9 dans le guide de AWS Cloud9 l'utilisateur.

Note

Lorsque vous créez votre environnement dans la console pour la première fois, nous vous recommandons de choisir l'option Créer une nouvelle instance pour environment (EC2). Cette option indique AWS Cloud9 de créer un environnement, de lancer une EC2 instance Amazon, puis de connecter la nouvelle instance au nouvel environnement. C'est le moyen le plus rapide de commencer à l'utiliser AWS Cloud9.

Si le terminal n'est pas déjà ouvert dans leIDE, ouvrez-le. Dans la barre de menuIDE, choisissez Fenêtre, Nouveau terminal. Vous pouvez utiliser la fenêtre du terminal pour installer des outils et créer vos applications.

Étape 3 : configurer le AWS SDK pour Ruby

Après avoir AWS Cloud9 ouvert le IDE pour votre environnement de développement, utilisez la fenêtre du terminal AWS SDK pour configurer Ruby dans votre environnement.

Vous pouvez installer le AWS SDK for Ruby comme vous le feriez pour n'importe quelle gemme Ruby. Les pierres précieuses sont disponibles sur RubyGems. Le AWS SDK for Ruby est conçu pour être modulaire et est séparé par Service AWS. L'installation de la aws-sdk gemme entière est volumineuse et peut prendre plus d'une heure.

Nous vous recommandons d'installer uniquement les gemmes pour Services AWS votre usage. Ils portent le même nom aws-sdk-service_abbreviation et la liste complète se trouve dans le tableau des services pris en charge du README fichier AWS SDK for Ruby. Par exemple, la gemme permettant de s'interfacer avec le service Amazon S3 est directement disponible sur aws-sdk-s3.

Gestionnaire de versions Ruby

Au lieu d'utiliser le système Ruby, nous vous recommandons d'utiliser un gestionnaire de version Ruby tel que le suivant :

Par exemple, si vous utilisez un système d'exploitation Amazon Linux 2, les commandes suivantes peuvent être utilisées pour effectuer une mise à jourRVM, répertorier les versions Ruby disponibles, puis choisir la version que vous souhaitez utiliser pour le développement avec AWS SDK for Ruby. La version minimale requise de Ruby est 2.3.

$ rvm get head
$ rvm list known
$ rvm install ruby-3.1.3
$ rvm --default use 3.1.3

Groupeur

Si vous utilisez Bundler, les commandes suivantes installent la gem AWS SDK for Ruby pour Amazon S3 :

  1. Installez Bundler et créez : Gemfile

    $ gem install bundler
$ bundle init

  2. Ouvrez le fichier créé Gemfile et ajoutez une gem ligne pour chaque gemme de AWS service que votre code utilisera. Pour suivre l'exemple Amazon S3, ajoutez la ligne suivante au bas du fichier :

    gem "aws-sdk-s3"

  3. Enregistrez le Gemfile.

  4. Installez les dépendances spécifiées dans votre Gemfile :

    $ bundle install

Étape 4 : Téléchargez un exemple de code

Utilisez la fenêtre du terminal pour télécharger un exemple de code AWS SDK pour Ruby dans l'environnement de AWS Cloud9 développement.

Pour télécharger une copie de tous les exemples de code utilisés dans la AWS SDK documentation officielle dans le répertoire racine de votre environnement, exécutez la commande suivante :

$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git

Les exemples de code AWS SDK pour Ruby se trouvent dans le ENVIRONMENT_NAME/aws-doc-sdk-examples/ruby répertoire, où se ENVIRONMENT_NAME trouve le nom de votre environnement de développement.

Pour suivre l'exemple d'Amazon S3, nous vous recommandons de commencer par un exemple de codeENVIRONMENT_NAME/aws-doc-sdk-examples/ruby/example_code/s3/bucket_list.rb. Utilisez la fenêtre du terminal pour accéder au s3 répertoire et répertorier les fichiers.

$ cd aws-doc-sdk-examples/ruby/example_code/s3
$ ls

Pour ouvrir le fichier AWS Cloud9, vous pouvez cliquer sur le bouton bucket_list.rb directement dans la fenêtre du terminal.

Étape 5 : Exécuter un exemple de code

Pour exécuter du code dans votre environnement de AWS Cloud9 développement, cliquez sur le bouton Exécuter dans la barre de menu supérieure. AWS Cloud9 détectera automatiquement l'extension du .rb fichier et utilisera le Ruby Runner pour exécuter le code. Pour plus d'informations sur l'exécution de code dans AWS Cloud9, voir Exécuter votre code dans le guide de AWS Cloud9 l'utilisateur.

Dans la capture d'écran suivante, notez ces domaines de base :

  • 1 : Courez. Le bouton Exécuter se trouve dans la barre de menu supérieure. Cela ouvre un nouvel onglet pour vos résultats.

    Note

    Vous pouvez également créer manuellement de nouvelles configurations d'exécution. Dans la barre de menus, choisissez Exécuter, Configurations d'exécution, Nouvelle configuration d'exécution.

  • 2 : Commande. AWS Cloud9 remplit la zone de texte Commande avec le chemin et le nom du fichier que vous exécutez. Si votre code s'attend à ce que des paramètres de ligne de commande soient transmis, ceux-ci peuvent être ajoutés à la ligne de commande de la même manière que vous le feriez lorsque vous exécutez le code via une fenêtre de terminal.

  • 3 : Coureur. AWS Cloud9 détecte l'extension de votre fichier .rb et sélectionne le Ruby Runner pour exécuter votre code.

Choisir Exécuter dans la barre de menu supérieure AWS Cloud9 IDE ouvre un nouvel onglet avec la zone de commande remplie et le Ruby Runner déjà sélectionné.

Toute sortie générée à partir du code en cours d'exécution s'affiche dans l'onglet.

Pour tester de nombreuses autres opérations Amazon S3, consultez le référentiel d'exemples de AWS code sur GitHub.