Préinstallation de la trousse SDK Oracle Cloud
Provisionnez une instance de calcul avec la trousse SDK Oracle Cloud préinstallée et prête à l'emploi.
Ce qui est inclus
Le modèle de trousse SDK Oracle Cloud préinstalle les articles Oracle Cloud Infrastructure suivants sur l'instance de calcul :
- Interface de ligne de commande (CLI)
- Fournisseur Terraform
- Ansible (inclut les modules Ansible pour OCI)
- Les trousses SDK suivantes :
- Git : Utilisez l'outil de ligne de commande Git fourni pour accéder à tous les systèmes de contrôle de version liés à Git, tels que Bitbucket, GitHub et GitLab.
L'autorisation du principal d'instance est configurée pour les articles installés et l'instance de calcul provisionnée. Un script de mise à niveau est également inclus.
Étapes d'utilisation de la trousse SDK Oracle Cloud
Pour provisionner une instance avec le kit de développement
-
Lancez la page Créer une pile pour le modèle Trousse SDK Oracle Cloud en sélectionnant ce bouton :
Autres étapes de la console- Dans la page de liste Piles, sélectionnez Créer une pile. Si vous avez besoin d'aide pour trouver la page de liste ou la pile, voir Liste des piles.
- Dans la page Créer une pile, sélectionnez Modèle.
- Sous Configuration de pile, sélectionnez Sélectionner un modèle.
- Dans le panneau Parcourir les modèles, sélectionnez Architecture.
- Sélectionnez la trousse SDK Oracle Cloud.Note
Vous devrez peut-être aller dans votre région principale pour que le modèle puisse être sélectionné.La cible revient à la page Créer une pile et le modèle de trousse SDK Oracle Cloud est sélectionné.
-
Suivez les invites pour enregistrer votre nouvelle pile et provisionner l'instance
- Dans la page Créer une pile, entrez le nom de la nouvelle pile (ou acceptez le nom par défaut). Évitez d'entrer des informations confidentielles.
- Facultativement, entrez une description.
-
Dans la liste déroulante Créer dans le compartiment, sélectionnez le compartiment dans lequel vous souhaitez créer la pile.
Un compartiment de la liste est défini par défaut.
Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
-
Sélectionnez Suivant.
Le panneau Configurer les variables affiche les variables suivantes :
- Forme de l'instance : Sélectionnez la forme à utiliser pour l'instance de calcul.
- Générer automatiquement une paire de clés SSH : Génère une paire de clés SSH ou vous permet de charger une clé publique.
- Activé (sélectionné) : Génère automatiquement une paire de clés SSH pour accéder à l'instance. La clé privée est stockée dans le fichier d'état Terraform. Vous utiliserez la clé privée plus tard pour vous connecter à l'instance.Important
N'utilisez pas cette option en production. Le fichier d'état Terraform contenant la clé privée est visible par toute personne ayant accès à la pile créée. - Désactivé (désactivé) : Permet de charger une clé publique. Aucune clé privée n'est stockée. Gardez la clé privée correspondante dans un endroit sûr. Vous utiliserez la clé privée plus tard pour vous connecter à l'instance.
Pour des instructions sur la génération de paires de clés SSH, voir Gestion des paires de clés sur des instances Linux.
- Activé (sélectionné) : Génère automatiquement une paire de clés SSH pour accéder à l'instance. La clé privée est stockée dans le fichier d'état Terraform. Vous utiliserez la clé privée plus tard pour vous connecter à l'instance.
- L'instance de calcul a accès à toutes les ressources au niveau de la location : Contrôle le niveau utilisé pour la politique de groupe dynamique, qui détermine quelles ressources sont accessibles par les utilisateurs de l'instance de calcul.
- Activé (sélectionné) : Niveau de location pour l'accès à toutes les ressources de la location.
- Désactivé (désactivé) : Niveau de compartiment pour l'accès à toutes les ressources du même compartiment que l'instance.
-
Sélectionnez Suivant.
-
Dans le panneau Vérifier, vérifiez la configuration de la pile.
-
Cochez la case Exécuter l'application.
Cette option provisionne automatiquement l'instance lors de la création de la pile.
-
Sélectionnez Créer pour créer votre pile et provisionner automatiquement l'instance.
La nouvelle pile apparaît dans la page Détails de la pile. Le gestionnaire de ressources exécute l'action Appliquer sur la nouvelle pile, en démarrant le processus de provisionnement de l'instance.
La nouvelle tâche d'application est indiquée sous Tâches. Surveillez son statut : La valeur "Succeeded" indique que la tâche est terminée. Pendant l'exécution de la tâche, ou après, vous pouvez télécharger son fichier journal.
Une fois l'instance provisionnée (indiquée par un statut "Réussite" pour la tâche d'application), l'installation des éléments de l'ensemble de développement commence. Le processus d'installation prend quelques minutes. Si vous êtes connecté à l'instance avant la fin de l'installation, un message d'avertissement indique que l'installation est toujours en cours. Une fois les éléments installés sur l'instance, vous pouvez les utiliser immédiatement.
-
Pour voir le fichier d'état Terraform (affiche l'état de vos ressources après l'exécution de la tâche), sélectionnez la tâche d'application (obtenir ses détails), puis sélectionnez Voir l'état sous Ressources.
Facultativement, sélectionnez Afficher les modifications dans cette version.
Félicitations! Vous avez provisionné une instance de calcul avec la trousse SDK Oracle Cloud déjà installée et prête à l'emploi. Vous pouvez maintenant vous connecter à l'instance et utiliser l'ensemble de développement.
Exécutez la commande suivante :
ssh -i <private-key> opc@<compute-instance-public-ip>
<private-key> est la clé privée associée à l'instance que vous avez provisionnée à partir de la pile créée à l'aide du modèle Outils pour développeurs Oracle Cloud.
<compute-instance-public-ip> est l'adresse IP de l'instance.
- Allez à la page Détails de la pile pour votre instance nouvellement provisionnée :
- Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Gestionnaire de ressources, sélectionnez Piles.
- Sélectionnez le nom de la pile pour afficher sa page de détails.
- Sélectionnez l'onglet Informations sur l'application.
- Copiez la valeur de l'adresse IP publique de l'instance de calcul.
- Pour la clé privée, suivez les étapes qui correspondent à l'option de clé que vous avez sélectionnée lors de la création de votre pile :
- Si vous avez activé Générer automatiquement une paire de clés SSH, extrayez la clé privée générée : Copiez la valeur de Clé privée générée pour l'accès SSH.
- Si vous avez désactivé la génération automatique de la paire de clés SSH, référencez le chemin complet et le nom du fichier qui contient la clé privée correspondant à la clé publique que vous avez chargée lors de la création de la pile. Note
Lorsque vous êtes connecté à votre instance, les autorisations de fichier de clé privée sont validées. Pour des raisons de sécurité, votre clé privée doit être accessible uniquement par le responsable. Sinon, vous ne serez pas autorisé à vous connecter à l'instance. (Les autorisations d'écriture du responsable sont requises pour que vous puissiez ajouter la clé privée au fichier.) Pour Unix ou Linux, utilisez la commandechmod 600 (-rw-------)
.
Pour des informations générales sur la connexion aux instances de calcul, voir Connexion à une instance.
Une fois connecté à votre instance, vous pouvez utiliser l'ensemble de développement installé.
Voir les exemples suivants :
- Interface de ligne de commande : Voir Utilisation de l'interface de ligne de commande
Syntaxe : Voir Provisionnement facile, Mises à jour de l'interface de ligne de commande
- Fournisseur Terraform
Utilisation : Voir Fournisseur Terraform.
- Ansible (inclut les modules Ansible pour OCI)
Utilisation : Voir Écriture d'un exemple de classeur.
- SDK :
- Exécuter
Syntaxe : Voir https://godoc.org/github.com/oracle/oci-go-sdk
- Java
Utilisation : Voir Concepts.
- Python
Configuration et utilisation : Voir Chiffrement côté client.
Configuration et utilisation des trousses SDK à code source libre : Voir Trousses SDK à code source libre
- Exécuter
- Git : Utilisez l'outil de ligne de commande Git fourni pour accéder à tous les systèmes de contrôle de version liés à Git, tels que Bitbucket, GitHub et GitLab.
Utilisation : Pour obtenir de l'aide sur l'utilisation de Git, accédez au terminal de votre nouvelle instance de calcul et exécutez
git --help
.
- Connectez-vous à l'instance que vous avez provisionnée à partir du modèle de trousse SDK Oracle Cloud.
- Exécutez la commande de mise à niveau :
update-kit.sh
Autorisation préconfigurée
L'autorisation du principal d'instance est configurée pour les articles de l'ensemble de développement installé et l'instance de calcul provisionnée. Le modèle fournit la préconfiguration suivante :
- groupe dynamique
- Une politique IAM, avec tous les accès aux ressources déterminés par la configuration de la pile (au niveau de la location ou du compartiment)
- Variables d'environnement définies dans
.bashrc
sur l'instance de calcul pour l'interface de ligne de commande, Terraform et Ansible
Pour plus d'informations sur l'autorisation du principal d'instance, voir Appel de services à partir d'une instance.