Introduction à l'utilisation de l'interface de ligne de commande
Cette rubrique fournit une procédure détaillée contenant les commandes requises pour lancer une instance Linux et une instance Windows. Ce tutoriel inclut l'utilisation d'un compartiment, la création d'un réseau cloud virtuel et le lancement d'instances.
L'interface de ligne de commande dispose d'un mode interactif qui fournit des informations et des suggestions sur les paramètres et l'exécution automatique des commandes. Pour plus d'informations, reportez-vous à la section Utilisation du mode interactif.
A propos de l'interface de ligne de commande (CLI)
La CLI est un outil compatible avec la plupart des services disponibles dans Oracle Cloud Infrastructure. La CLI offre les mêmes fonctionnalités de base que la console, ainsi que des commandes supplémentaires. Les fonctionnalités de la CLI et l'aide sur les commandes sont basées sur l'API du service.
Obtention d'aide sur les commandes
Vous pouvez afficher une aide incorporée en utilisant le mot-clé --help
, -h
ou -?
. Par exemple :
oci --help
oci bv volume -h
oci os bucket create -?
Vous pouvez également afficher l'intégralité de l'aide de la CLI dans le navigateur.
A propos des exemples de CLI
Les exemples de ce document sont regroupés sous la forme d'une commande et d'une réponse, où :
- vous êtes informé de l'action de la commande et avez la possibilité d'utiliser la commande ;
- le résultat de la commande est renvoyé dans une zone de texte déroulante.
L'exemple suivant présente un groupe commande-réponse.
Pour obtenir l'espace de noms de votre location, exécutez la commande suivante.
oci os ns get
Présentation de la sortie de réponse
oci os ns get
affiche la sortie standard, renvoyée au format JSON. Les objets JSON sont écrits en tant que paires clé/valeur, la clé et la valeur étant séparées par un signe deux-points. Par exemple :
{
"data": "docs"
"id": "ocid1.compartment.oc1..aaaaaaaal3gzijdhqol2pglie6astxxeyqdqeyg35nz5zxil2rggnx7jnhwa"
"is-stateless": null
}
Une clé comme "id"
ne donne pas beaucoup d'informations. Pour comprendre la référence d'objet JSON, vous devez lire la valeur de la clé.{
"data": "docs"
}
La plupart des groupes commande-réponse de ce guide ne sont pas aussi simples que dans l'exemple précédent. Cependant, au fil des tâches, elles deviennent plus faciles à lire et à utiliser.
Avant de commencer
Avant de commencer à utiliser l'interface de ligne de commande, vérifiez que vous respectez toutes les conditions requises décrites dans Interface de ligne de commande (CLI).
Il est recommandé d'effectuer les tâches de ce tutoriel dans un environnement de test. Cette approche garantit que les configurations n'affectent pas les autres environnements de la location. A la fin du tutoriel, vous pouvez supprimer les ressources de test en toute sécurité.
Utilisation d'un compartiment
Dans ce tutoriel, vous utilisez un seul compartiment pour toutes vos ressources. Lorsque vous serez prêt à créer un environnement de production, ces ressources seront probablement réparties dans différents compartiments.
Vous pouvez utiliser un compartiment existant (recommandé) ou créer un compartiment.
Choix du compartiment
Aide : oci iam compartment list -h
Pour obtenir la liste des compartiments de votre location, exécutez la commande suivante.
oci iam compartment list -c <tenancy_id>
oci iam compartment list -c ocid1.tenancy.oc1..aaaaaaaal1fvgn0h9njji5u6ldrwb4l6aay2x87qatw2wte30f714lal9oom
{
"data": [
{
"compartment-id": "ocid1.tenancy.oc1..aaaaaaaal1fvgn0h9njji5u6ldrwb4l6aay2x87qatw2wte30f714lal9oom",
"description": "For testing CLI features",
"id": "ocid1.tenancy.oc1..aaaaaaaal1fvgn0h9njji5u6ldrwb4l6aay2x87qatw2wte30f714lal9oom",
"inactive-status": null,
"lifecycle-state": "ACTIVE",
"name": "CLIsandbox",
"time-created": "2017-06-27T18:52:52.214000+00:00"
},
{
"compartment-id": "ocid1.tenancy.oc1..aaaaaaaal1fvgn0h9njji5u6ldrwb4l6aay2x87qatw2wte30f714lal9oom",
"description": "for testing",
"id": "ocid1.compartment.oc1..aaaaaaaasqn3hj6e5tq6slj4rpdqqja7qsyuqipmu4sv5ucmyp3rkmrhuv2q",
"inactive-status": null,
"lifecycle-state": "ACTIVE",
"name": "CLISandbox",
"time-created": "2017-05-12T21:31:27.709000+00:00"
}
],
"opc-next-page": " AAAAAAAAAAGLB28zJTjPUeNvgmLxg9QuJdAAZrl10FfKymIMh4ylXItQkO_Xk6RXbGxCn8hgkYm_pRpf1v6hVoxrYTQsaoveGMkX6iwwwPY5dptL8AKlyogYSs7F3G92KG2EhrI7j4NoUBtJ4-PTB53F2TZ31dReLsbzxBa3ljbwqQgwzQsUPYROLXA40EIJFdr2oYp67AzozSW8jt8MWFC8y19PsHEEEBW1jw8TT7Lq8XL_7mo5avasfsIYS7-VgP3ZFu6Y-Rab-gPNtjsT4pLh91BkDKWzbyHr0OmH4W1rhTJ5HfZ8YGpA0Ntm7_rOyNBd06qeBU496AQHk24-U_l9p4NvAvHuJ_fR-Z6ahgvWPlZQc1iCTRlJ6leM7ED3JNehIV0onOVQvGquJpF2WeEWFPcioQaqf4iScqHEchV--3Mn2k1yP_-b4AsVtSPRFYG8UuiRACPzg6ENVFjyeGOk3rrHjLR3j7s61pdgqtMOKZ1WtbOV8AcNON8ac1xJPN7O2YmjO3D0H4JmzXh_GxRskTpkl1D9En9zJXn99oWsNBOYgQQmv7s_7j82ZrXGoyOME-iT"
}
Création d'un compartiment
Aide : oci iam compartment create -h
Avant de créer un compartiment, reportez-vous à Utilisation des compartiments pour comprendre la conception des compartiments, la gestion des ressources et les contraintes sur les compartiments.
Pour créer un compartiment, exécutez la commande suivante.
oci iam compartment create --name <compartment_name> -c <root_compartment_id> --description "<friendly_description>"
oci iam compartment create --name CLIsandbox -c ocid1.tenancy.oc1..aaaaaaaal1fvgn0h9njji5u6ldrwb4l6aay2x87qatw2wte30f714lal9oom --description "For testing CLI features"
{
"data": {
"compartment-id": "ocid1.tenancy.oc1..aaaaaaaawuu4tdkysd2ups5fsclgm5ksfjwmx6mwem5sbjyw5ob5ojq2vkxa",
"description": "For testing CLI features",
"id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l",
"inactive-status": null,
"lifecycle-state": "ACTIVE",
"name": "CLIsandbox",
"time-created": "2017-06-27T18:52:52.214000+00:00"
},
"etag": "24a4737ede9d34eae934c93e9549ee684a15efc8"
}
"compartment-id": "ocid1.tenancy.oc1..aaaaaaaawuu4tdkysd2ups5fsclgm5ksfjwmx6mwem5sbjyw5ob5ojq2vkxa"
Création d'un réseau cloud virtuel
Pour pouvoir lancer des instances, vous devez créer un réseau cloud virtuel et les ressources associées. Les tâches suivantes sont utilisées pour préparer l'environnement réseau :
-
Création du réseau cloud virtuel
Aide :
oci network vcn create -h
Créez le réseau cloud virtuel en indiquant un nom DNS et une plage de blocs CIDR.
Pour créer le réseau cloud virtuel, exécutez la commande suivante.
oci network vcn create --compartment-id <compartment_id> --display-name "<friendly_name>" --dns-label <dns_name> --cidr-block "<0.0.0.0/0>"
Exemple de commande et réponseoci network vcn create --compartment-id ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --display-name "cli_vcn" --dns-label sandboxvcn1 --cidr-block "10.0.0.0/16"
{ "data": { "cidr-block": "10.0.0.0/16", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "default-dhcp-options-id": "ocid1.dhcpoptions.oc1.phx.aaaaaaaaexnsdwsjmxnmmt4tpzkcbyengrnfpgnqzlkzz7qfx6faeqfbtcfa", "default-route-table-id": "ocid1.routetable.oc1.phx.aaaaaaaagdjre4rmk5dq6qqkftjtzyn7vctemqga3i6qrxvf23stedpujo2q", "default-security-list-id": "ocid1.securitylist.oc1.phx.aaaaaaaaxa3cr5zqshmed7zf64bxcrxb2zerinxhc52zrqe5w27hrau75j2q", "display-name": "cli_vcn", "dns-label": "sandboxvcn1", "id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr", "lifecycle-state": "AVAILABLE", "time-created": "2017-06-27T22:14:15.683000+00:00","vcn-domain-name": "sandboxvcn1.oraclevcn.com" }, "etag": "9037efc5" }
Vous pouvez obtenir des informations sur vos configurations en envoyant des requêtes à votre location.
Par exemple, pour obtenir les informations réseau, exécutez la commande suivante.
oci network vcn list -c <compartment_id>
Exemple de commande et réponseoci network vcn list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l
{ "data": [ { "cidr-block": "10.0.0.0/16", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "default-dhcp-options-id": "ocid1.dhcpoptions.oc1.phx.aaaaaaaaexnsdjmxncbydrwrnfwspgnqzlkzz7qfmmt4tpzkx6faeqfbtcfa", "default-route-table-id": "ocid1.routetable.oc1.phx.aaaaaaaagdjre4jtzyn7vctmqga3i6qrxvf2rmk5dqdrwqkft3stedpujo2q", "default-security-list-id": "ocid1.securitylist.oc1.phx.aaaaaaaaxa3cr5zqsdrwxb2zerinxhc52zrqe5wmed74bxczf27hrau75j2q", "display-name": "cli_vcn", "dns-label": "sandboxvcn1", "id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr", "lifecycle-state": "AVAILABLE", "time-created": "2017-06-27T22:14:15.683000+00:00", "vcn-domain-name": "sandboxvcn1.oraclevcn.com" } ] }
-
Configuration d'une règle d'entrée de liste de sécurité
Aide :
oci network security-list create -h
Lorsque vous créez un réseau cloud virtuel, une liste de sécurité par défaut est créée. Toutefois, l'instance Windows exige également que le trafic entrant soit activé pour le port 3389. Cette approche consiste à créer une deuxième liste qui répond aux exigences du port Windows. L'option
--security-list-ids
permet d'associer les deux listes de sécurité au sous-réseau lorsque vous le créez.Remarque
Transmission de chaînes JSON dans l'interface de ligne de commande
La commande suivante transmet une entrée complexe sous la forme d'une chaîne de texte JSON. Pour obtenir de l'aide sur le formatage de l'entrée JSON, en particulier lorsque vous travaillez dans un environnement Windows, reportez-vous à Transmission d'une entrée complexe.
Pour créer une liste de sécurité et configurer la règle entrante pour le port 3389, exécutez la commande suivante.
oci network security-list create -c <compartment_id> --egress-security-rules "[{"destination": "<0.0.0.0/0>", "protocol": "<6>", "isStateless": <true>, "tcpOptions": {"destinationPortRange": <null>, "sourcePortRange": <null>}}]" --ingress-security-rules "[{"source": "<0.0.0.0/0>", "protocol": "<6>", "isStateless": <false>, "tcpOptions": {"destinationPortRange": {"max": <3389>, "min": <3389>}, "sourcePortRange": <null>}}]" --vcn-id <vcn_id> --display-name <rule_name>
Exemple de commande et réponseoci network security-list create -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --egress-security-rules "[{"destination": "0.0.0.0/0", "protocol": "6", "isStateless": true, "tcpOptions": {"destinationPortRange": null, "sourcePortRange": null}}]" --ingress-security-rules "[{"source": "0.0.0.0/0", "protocol": "6", "isStateless": false, "tcpOptions": {"destinationPortRange": {"max": 3389, "min": 3389}, "sourcePortRange": null}}]" --vcn-id ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr --display-name port3389rule
{ "data": { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "port3389rule", "egress-security-rules": [ { "destination": "0.0.0.0/0", "icmp-options": null, "is-stateless": true, "protocol": "6", "tcp-options": { "destination-port-range": { "max": null, "min": null }, "source-port-range": null }, "udp-options": null } ], "id": "ocid1.securitylist.oc1.phx.aaaaaaaa7snx4jjfons6o2h33drwdh5hev6elir55hnrhi2ywqfnd5rcqk4q", "ingress-security-rules": [ { "icmp-options": null, "is-stateless": false, "protocol": "6", "source": "0.0.0.0/0", "tcp-options": { "destination-port-range": { "max": 3389, "min": 3389 }, "source-port-range": null }, "udp-options": null } ], "lifecycle-state": "AVAILABLE", "time-created": "2017-08-23T19:50:58.104000+00:00", "vcn-id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr" }, "etag": "d063779e" }
-
Création d'un sous-réseau
Aide :
oci iam availability-domain list -h
,oci network subnet create -h
Dans cette étape, vous devez fournir les OCID de la liste de sécurité par défaut et de la nouvelle liste de sécurité. Si vous n'avez pas enregistré ces OCID, utilisez la commande
oci network security-list list
pour obtenir la liste des listes de sécurité dans le réseau cloud virtuel.Avant de créer un sous-réseau, vous devez déterminer les domaines de disponibilité disponibles pour la création du sous-réseau.
Pour obtenir la liste des domaines de disponibilité de votre compartiment, exécutez la commande suivante.
oci iam availability-domain list -c <compartment_id>
Exemple de commande et réponseoci iam availability-domain list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l
{ "data": [ { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "name": "EMIr:PHX-AD-1" }, { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "name": "EMIr:PHX-AD-2" }, { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "name": "EMIr:PHX-AD-3" } ] }
Pour créer un sous-réseau dans AD-1, exécutez la commande suivante.
oci network subnet create --vcn-id <vcn_id> -c <compartment_id> --availability-domain "<availability_domain_name>" --display-name <display_name> --dns-label "<dns_label>" --cidr-block "<10.0.0.0/16>" --security-list-ids "["<default_security_list_id>","<new_security_list_id>"]"
Exemple de commande et réponseoci network subnet create --vcn-id ocid1.vcn.oc1.phx.aaaaaaaah2ast7desae6ok3amu64wozj3kskox75awryr5j2nd7tkocplajq -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --availability-domain "EMIr:PHX-AD-1" --display-name CLISUB --dns-label "vminstances" --cidr-block "10.0.0.0/16" --security-list-ids "["ocid1.securitylist.oc1.phx.aaaaaaaaw7c62ybv4f5drwv2mup3f75aiquhbkbh4s676muq5t7j5tjckvlq","ocid1.securitylist.oc1.phx.aaaaaaaa7snx4jjfons6o2h33drwdh5hev6elir55hnrhi2ywqfnd5rcqk4q"]"
{ "data": { "availability-domain": "EMIr:PHX-AD-1", "cidr-block": "10.0.0.0/16", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "dhcp-options-id": "ocid1.dhcpoptions.oc1.phx.aaaaaaaaexnsdjmxnmmt4tpzkengrnfwspgnqzldrw7qfx6cbyfaeqfbtcfa", "display-name": "CLISUB", "dns-label": "vminstances", "id": "ocid1.subnet.oc1.phx.aaaaaaaahvx05fhw7p320cxmdrwo5wlf50egig9cmdzs1plb1xl6c5wvb5s2", "lifecycle-state": "PROVISIONING", "prohibit-public-ip-on-vnic": false, "route-table-id": "ocid1.routetable.oc1.phx.aaaaaaaagdjqga3i6qrxvf23stedpre4rmkdrw6qeqkftjtzyn7vctmujo2q", "security-list-ids": [ "ocid1.securitylist.oc1.phx.aaaaaaaaw7c62ybv4f5drwv2mup3f75aiquhbkbh4s676muq5t7j5tjckvlq", "ocid1.securitylist.oc1.phx.aaaaaaaa7snx4jjfons6o2h33drwdh5hev6elir55hnrhi2ywqfnd5rcqk4q" ], "subnet-domain-name": vminstances.sandboxvcn1.oraclevcn.com, "time-created": "2017-08-24T00:51:30.462000+00:00", "vcn-id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr", "virtual-router-ip": "10.0.0.1", "virtual-router-mac": "00:00:17:7F:8A:D7" }, "etag": "92d20c35" }
-
Création d'une passerelle Internet
Aide :
oci network internet-gateway create -h
Pour créer une passerelle Internet, exécutez la commande suivante.
oci network internet-gateway create -c <compartment_id> --is-enabled <true> --vcn-id <vcn_id> --display-name <gateway_display_name>
Exemple de commande et réponseoci network internet-gateway create -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --is-enabled true --vcn-id ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr --display-name sbgateway
{ "data": { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "sbgateway", "id": "ocid1.internetgateway.oc1.phx.aaaaaaaa3vcd7gmqqh4po6wnsjhcdkxlddeqinmnbanzz2wsh5gdrwt574ka", "is-enabled": true, "lifecycle-state": "AVAILABLE", "time-created": "2017-08-25T20:03:48.482000+00:00", "vcn-id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr" }, "etag": "d13fb7e3" }
-
Ajout d'une règle à la table de routage
Aide :
oci network route-table list -h
,oci network route-table update -h
Lorsque vous créez un réseau cloud virtuel, une table de routage est créée automatiquement. Pour ajouter une règle à la table de routage, vous avez besoin de l'OCID de la table.
Pour obtenir l'OCID de la table de routage, exécutez la commande suivante.
oci network route-table list -c <compartment_id> --vcn-id <vcn_id>
Exemple de commande et réponseoci network route-table list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --vcn-id ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr
{ "data": [ { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Default Route Table for cli_vcn", "id": "ocid1.routetable.oc1.phx.aaaaaaaagdjqga3i6qrxvf23stedpre4rmkdrw6qeqkftjtzyn7vctmujo2q", "lifecycle-state": "AVAILABLE", "route-rules": [], "time-created": "2017-08-25T21:46:04.324000+00:00", "vcn-id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr" } ] }
Les informations de la réponse précédente indiquent qu'il existe une table de routage sans règle :
"route rules":[]
. Comme la table existe, vous créez une règle en mettant à jour la table. Lorsque vous exécutez la commande suivante, vous recevez un avertissement concernant les mises à jour des règles de routage. Toute mise à jour des règles de routage remplace toutes les règles existantes. Pour continuer et effectuer la mise à jour, entrez "y".Pour mettre à jour les règles de routage, exécutez la commande suivante.
oci network route-table update --rt-id <route_table_id> --route-rules "[{"cidrBlock":"<0.0.0.0/0>","networkEntityId":"<internet_gateway_id>"}] WARNING: Updates to route-rules will replace any existing values. Are you sure you want to continue? [y/N]: y
Exemple de commande et réponseoci network route-table update --rt-id ocid1.routetable.oc1.phx.aaaaaaaagdjqga3i6qrxvf23stedpre4rmkdrw6qeqkftjtzyn7vctmujo2q --route-rules "[{"cidrBlock":"0.0.0.0/0","networkEntityId":"ocid1.internetgateway.oc1.phx.aaaaaaaa3vcd7gmqqh4po6wnsjhcdkxlddeqinmnbanzz2wsh5gdrwt574ka"}] WARNING: Updates to route-rules will replace any existing values. Are you sure you want to continue? [y/N]: y
{ "data": { "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Default Route Table for cli_vcn", "id": "ocid1.routetable.oc1.phx.aaaaaaaa4kujevzdsnd7bh6aetvrhvzdrwcxmmblspmyj3pqwckchajvz6fa", "lifecycle-state": "AVAILABLE", "route-rules": [ { "cidr-block": "0.0.0.0/0", "network-entity-id": "ocid1.internetgateway.oc1.phx.aaaaaaaa3vcd7gmqqh4po6wnsjhcdkxlddeqinmnbanzz2wsh5gdrwt574ka" } ], "time-created": "2017-08-25T23:46:04.324000+00:00","vcn-id": "ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr" }, "etag": "3fc998d8" }
Préparation du lancement d'une instance
Lorsque vous lancez une instance, vous devez fournir les informations suivantes, dont certaines que vous avez déjà :
compartment-id
availability-domain
subnet-id
image-id
shape
-
Obtention d'informations sur les images disponibles
Aide :
oci compute image list -h
L'élément
image-id
identifie le système d'exploitation à installer. Pour plus d'informations, reportez-vous à Images de plate-forme.Pour obtenir la liste des images, exécutez la commande suivante.
oci compute image list -c <compartment_id>
Exemple de commande et réponseDes images sont disponibles pour Oracle Linux, CentOS, Ubuntu et Windows Server. Cet exemple de réponse présente uniquement les informations pour Oracle Linux 7.3.
oci compute image list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l
{ "base-image-id": null, "compartment-id": null, "create-image-allowed": true, "display-name": "Oracle-Linux-7.3-2017.03.03-0", "id": "ocid1.image.oc1.phx.aaaaaaaaevkccomzepja4yhahz6rguhqbuomuto7gdrw5hjimqsig6syeqda", "lifecycle-state": "AVAILABLE", "operating-system": "Oracle Linux", "operating-system-version": "7.3", "time-created": "2017-03-03T19:04:30.824000+00:00" }
-
Obtention d'informations sur les formes disponibles
Aide :
oci compute shape list -h
La forme identifie la configuration de la machine virtuelle ou de l'hôte Bare Metal à utiliser. La rubrique Formes de calcul contient des informations à jour sur les formes disponibles.
Pour les besoins de cette procédure pas à pas, utilisez cette forme de machine virtuelle à des fins de test :
--shape "VM.Standard1.1"
. Cette forme est configurée avec 1 UC et 7 Go de mémoire.Remarque
Dimensionnement de volume de blocs et de formes
Le dimensionnement des formes d'instance de calcul et des volumes de blocs ne fait pas partie de cette procédure pas à pas. Les exemples utilisent les tailles minimales disponibles.
Pour obtenir la liste de toutes les formes de machine virtuelle et Bare Metal disponibles, exécutez la commande suivante.
oci compute shape list -c <compartment_id> --availability-domain "<availability_domain_name>"
Exemple de commande et réponseoci compute shape list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --availability-domain "EMIr:PHX-AD-1"
{ "data": [ { "shape": "BM.Standard1.36" }, { "shape": "VM.Standard1.1" }, { "shape": "VM.Standard1.2" }, { "shape": "VM.Standard1.4" }, { "shape": "VM.Standard1.8" }, { "shape": "VM.Standard1.16" }, { "shape": "VM.DenseIO1.4" } ] }
Lancement d'une instance Linux
Vous êtes désormais prêt à lancer une instance Linux basée sur les configurations que vous avez préparées.
-
Utilisation d'une paire de clés publique/privée pour se connecter à l'instance
Lorsque vous lancez une instance à l'aide de l'interface de ligne de commande, vous devez disposer d'une paire de clés existante pour accéder à l'instance. (Cette paire de clés n'est pas la même qu'une clé de signature d'API.)
-
Lancement de l'instance
Aide :
oci compute instance launch -h
Attention
Dans cet exemple, le paramètre
--ssh-authorized-keys-file
fait référence à un fichier contenant la clé publique requise pour accéder à l'instance de calcul. Si vous ne fournissez pas cette clé lors du lancement de l'instance, vous ne pourrez pas vous connecter à l'instance après son lancement.Pour lancer l'instance Linux, exécutez la commande suivante.
oci compute instance launch --availability-domain "<availability_domain_name>" -c <compartment_id> --shape "<shape_name>" --display-name "<instance_display_name>" --image-id <image_id> --ssh-authorized-keys-file "<path_to_authorized_keys_file>" --subnet-id <subnet_id>
Exemple de commande et réponseoci compute instance launch --availability-domain "EMIr:PHX-AD-1" -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --shape "VM.Standard1.1" --display-name "Linux Instance" --image-id ocid1.image.oc1.phx.aaaaaaaa5yu6pw3riqtuhxzov7fdngi4tsteganmao54nq3pyxu3hxcuzmoa --ssh-authorized-keys-file "C:\Users\testuser\.oci\linux_key.pem" --subnet-id ocid1.subnet.oc1.phx.aaaaaaaahvx05fhw7p320cxmdrwo5wlf50egig9cmdzs1plb1xl6c5wvb5s2
{ "data": { "availability-domain": "EMIr:PHX-AD-1", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Linux Instance", "extended-metadata": {}, "id": "ocid1.instance.oc1.phx.abyhqljrtv7hhenrra6hsdrwjqvszcr2gs7c76tuuzc33iyl6bz5mfnbzw7q", "image-id": "ocid1.image.oc1.phx.aaaaaaaa5yu6pw3riqtuhxzov7fdngi4tsteganmao54nq3pyxu3hxcuzmoa", "ipxe-script": null, "lifecycle-state": "RUNNING", "metadata": { "ssh_authorized_keys": "ssh-rsa AAAAB3NzaABJQAAAQC1yc2EAAAEAtaT/s9HZ24VeLUxcBNT//nPygk75BWpA+kuQotpH4yP1tpqJvOBZoTKwoYa0BuoVcY4VP1GkuCEUrpojZ5F6LybbVeO+ixpuxcPTRNZcVPZJfUVZqg7u8CCjih2T9qH9ZrOcXBJCyKrxEE2kkP4RunnS38MvuDnySYus/04V8l7sEudqWWQX88iZO4oV+Sc4vljbZIaOqNrlAJV5xfQHISL2Ejq8Q1JKaO2Mc6D4Ku/6qEwe0ihtPGoi0zFmPoWstfgc1UqTdiRsYECzzaWqVYpl7RO5h4pIP6/lgBfOsv/Dcg19ND7/qKnmJ4/9iKuacI2bm+HF2oR0gY4C2MvL3Q== rsa-key-20817080\n" }, "region": "phx", "shape": "VM.Standard1.1", "time-created": "2017-08-26T20:39:03.340000+00:00" }, "etag": "2df9d1f14856a2e9a0cc239417f1ee829288b8badeb7ac6fb6d5b3553cbd148c--gzip" }
-
Obtention des informations de VNIC pour l'instance
Aide :
oci compute instance list-vnics -h
Vous avez besoin de l'adresse IP publique de l'instance pour vous connecter à l'instance. La carte d'interface réseau virtuelle de l'instance contient ces informations.
Pour obtenir la listes des cartes d'interface réseau virtuelles, exécutez la commande suivante.
oci compute instance list-vnics --instance-id <instance_id>
Exemple de commande et réponseoci compute instance list-vnics --instance-id ocid1.instance.oc1.phx.abcdefgh6kykdowc8ozzvr4421kwp7apdrwk6wrjl7su82d60c6sp4nap88d
{ "data": [ { "availability-domain": "EMIr:PHX-AD-1", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Linux Instance", "hostname-label": null, "id": "ocid1.vnic.oc1.phx.abyhqljrxqrdrwuhj4nly7dp7ctr7xvclvejc7pu5rq77e37vlsq2al5y74a", "lifecycle-state": "AVAILABLE", "private-ip": "10.0.0.2", "public-ip": "129.145.32.236", "subnet-id": "ocid1.subnet.oc1.phx.aaaaaaaahvx05fhw7p320cxmdrwo5wlf50egig9cmdzs1plb1xl6c5wvb5s2", "time-created": "2017-08-24T00:51:30.462000+00:00" } [ }
-
Création d'un volume de blocs pour l'instance
Aide :
oci bv volume create -h
Créez un volume de blocs en utilisant la taille minimale disponible.
Attention
Les tailles de volume de blocs sont exprimées par incréments de 1 024 Mo. L'exemple de commande suivant utilise la taille minimale,
--size-in-mbs 51200
ou 50 Go.Pour créer un volume de blocs, exécutez la commande suivante.
oci bv volume create --availability-domain "<availability_domain_name>" -c <compartment_id> --size-in-mbs <51200> --display-name <volume_display_name>
Exemple de commande et réponseoci bv volume create --availability-domain "EMIr:PHX-AD-1" -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --size-in-mbs 51200 --display-name LinuxVol
{ "data": { "availability-domain": "EMIr:PHX-AD-1", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "LinuxVol", "id": "ocid1.volume.oc1.phx.abyhqlsktp2ec7pdazl4y324drw5lxruh5nxjrgbgqq7znsj5oo4t25nvcta", "lifecycle-state": "PROVISIONING", "size-in-mbs": 51200, "time-created": "2017-08-26T00:51:30.462000+00:00" }, "etag": "720652578" }
Une fois que l'état de cycle de vie passe de "PROVISIONING" à "AVAILABLE", vous pouvez attacher le volume à l'instance Linux.
Conseil
Recherche de l'état de cycle de vie
Vous pouvez déterminer l'état de cycle de vie du volume de blocs à l'aide de la commande
oci bv volume get
pour le volume que vous avez créé. Vous pouvez également interroger d'autres ressources, telles que des instances de calcul et des cartes d'interface réseau virtuelles, pour trouver leur état de cycle de vie. -
Attachement du volume de blocs à l'instance
Aide :
oci compute volume-attachment attach -h
Pour attacher le volume de blocs à l'instance Linux, exécutez la commande suivante.
oci compute volume-attachment attach --instance-id <instance_id> --type <iscsi> --volume-id <volume_id>
Exemple de commande et réponseoci compute volume-attachment attach --instance-id ocid1.instance.oc1.phx.abcdefgh6kykdowc8ozzvr4421kwp7apdrwk6wrjl7su82d60c6sp4nap88d --type iscsi --volume-id ocid1.volume.oc1.phx.abyhqljrgbktp2ec7pdazl4y324drw5lxruh5nxt25gqq7znsj5oo4snvcta
{ "data": { "attachment-type": "iscsi", "availability-domain": "EMIr:PHX-AD-1", "chap-secret": null, "chap-username": null, "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": null, "id": "ocid1.volumeattachment.oc1.phx.abyhqlytoivg6eaybdrwb7mqqms6utjrefofrplyip7filf3vtpk55h2hzlq", "instance-id": "ocid1.instance.oc1.phx.abcdefgh6kykdowc8ozzvr4421kwp7apdrwk6wrjl7su82d60c6sp4nap88d", "ipv4": null, "iqn": null, "lifecycle-state": "ATTACHING", "port": null, "time-created": "2017-08-26T00:55:30.462000+00:00", "volume-id": "ocid1.volume.oc1.phx.fewtr0p6pm9lj7h7rpf8w3drwlf4x9tadrw1sbs7n5qkx7dcu7bk" }, "etag": "0c0afdb14a0a10ffc15283366798ac82f623433e6f5619eb2d4469612b32a332" }
Lancement d'une instance Windows
Le lancement d'une instance Windows suit le même modèle et requiert les mêmes informations que le lancement d'une instance Linux. Les seules grandes différences sont le système d'exploitation et la forme, comme illustré dans les commandes suivantes.
-
Lancement de l'instance
Aide :
oci compute instance launch -h
Pour lancer l'instance Windows, exécutez la commande suivante.
oci compute instance launch --availability-domain "<availability_domain_name>" -c <compartment_id> --shape "<shape_name>" --display-name "<instance_display_name>" --image-id <image_id> --subnet-id <subnet_id>
Exemple de commande et réponseoci compute instance launch --availability-domain "EMIr:PHX-AD-1" -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l --shape "VM.Standard1.2" --display-name "Windows Instance" --image-id ocid1.image.oc1.phx.aaaaaaaa53cliasgvqmueus5byytfldrwafbro2y4ywjebci5szc42e2b7ua --subnet-id ocid1.subnet.oc1.phx.aaaaaaaaypsr25bzjmj3drwiha6lodzus3yn6xwgkcrgxdgafscirbhj5bpa
{ "data": { "availability-domain": "EMIr:PHX-AD-1", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Windows Instance", "extended-metadata": {}, "id": "ocid1.instance.oc1.phx.zsutzirph7cbrbx6rzu91stavdrw58puq3isknlr07zfcd6rq6p9", "image-id": "ocid1.image.oc1.phx.aaaaaaaa53cliaskafbro2y4drwebci5szc4eus5bygvqmutflwqy2e2b7ua", "ipxe-script": null, "lifecycle-state": "PROVISIONING", "metadata": {}, "region": "phx", "shape": "VM.Standard1.2", "time-created": "2017-08-26T00:51:30.462000+00:00" }, "etag": "4ec3da1e2415c49f55ed705c4d81edb2739da62946d36d73f816e8241e705b3b" }
-
Obtention des informations de VNIC pour l'instance
Pour obtenir les informations de VNIC, exécutez la commande suivante.
oci compute instance list-vnics --instance-id <instance_id>
-
Création d'un volume de blocs pour l'instance
Pour créer un volume de blocs, exécutez la commande suivante.
oci bv volume create --availability-domain "<availability_domain_name>" -c <compartment_id> --size-in-mbs <51200> --display-name <display_name>
-
Attachement du volume de blocs à l'instance
Pour attacher le volume de blocs à l'instance Windows, exécutez la commande suivante.
oci compute volume-attachment attach --instance-id <instance_id> --type <iscsi> --volume-id <volume_id>
Connexion à vos instances
Bien que l'adresse IP publique soit requise pour la connexion aux instances Linux et Windows, il s'agit de la seule chose que les deux ont en commun. Voici quelques-unes de leurs différences : authentification, configuration de port et programmes client de bureau.
-
Connexion à votre instance Linux
La section Connexion à votre instance explique comment se connecter à une instance Linux à partir d'un système de type Unix ou Windows.
-
Connexion à votre instance Windows
Aide :
oci compute instance list-vnics -h
etoci compute instance get-windows-initial-creds -h
Pour vous connecter à l'instance à l'aide de Remote Desktop Client (RDC), vous avez besoin des éléments suivants :
- Adresse IP publique de l'instance
- Informations d'identification Windows initiales
Pour obtenir l'adresse IP publique de l'instance Windows, exécutez la commande suivante.
oci compute instance list-vnics --instance-id <instance_id>
Exemple de commande et réponseoci compute instance list-vnics --instance-id ocid1.instance.oc1.phx.zsutzirph7cbrbx6rzu91stavdrw58puq3isknlr07zfcd6rq6p9
{ "data": [ { "availability-domain": "EMIr:PHX-AD-1", "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": "Windows Instance", "hostname-label": null, "id": "ocid1.vnic.oc1.phx.abyhqljr5m5mmra3ecxasw6vdrwq5ft23dqn4dlrl45hdggz6rgfdwpp4ija", "lifecycle-state": "AVAILABLE", "private-ip": "10.10.0.3", "public-ip": "129.142.0.212", "subnet-id": "ocid1.subnet.oc1.phx.aaaaaaaahvx05fhw7p320cxmdrwo5wlf50egig9cmdzs1plb1xl6c5wvb5s2", "time-created": "2017-08-26T00:51:30.462000+00:00" } ] }
Pour obtenir les informations d'identification Windows initiales, exécutez la commande suivante.
oci compute instance get-windows-initial-creds --instance-id <instance_id>
Exemple de commande et réponseoci compute instance get-windows-initial-creds --instance-id ocid1.instance.oc1.phx.zsutzirph7cbrbx6rzu91stavdrw58puq3isknlr07zfcd6rq6p9
{ "data": { "password": "Cz{73~~vf@dnK7A", "username": "opc" } }
La section Connexion à votre instance Windows décrit la procédure de connexion à votre instance à l'aide de RDC.
Nettoyage de l'environnement de test
Une fois que vous avez terminé de configurer les environnements de test décrits dans ce tutoriel, nettoyez-les en enlevant les ressources que vous n'utilisez pas.
Détachement et suppression des volumes de blocs
Aide : oci compute volume-attachment list -h
, oci compute volume-attachment detach -h
et oci bv volume delete -h
La suppression d'un volume de blocs d'une instance est un processus en 3 étapes. Suivez ces étapes pour détacher et supprimer le volume de blocs de l'instance Linux.
-
Obtention de l'ID
volume-attachment-id
L'ID d'attachement de volume est créé lorsque vous créez un volume de blocs.
Pour obtenir l'ID d'attachement de volume, exécutez la commande suivante.
oci compute volume-attachment list -c <compartment_id>
Exemple de commande et réponseoci compute volume-attachment list -c ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l
{ "data": [ { "attachment-type": "iscsi", "availability-domain": "EMIr:PHX-AD-1", "chap-secret": null, "chap-username": null, "compartment-id": "ocid1.compartment.oc1..aaaaaaaalkqnr7pfd92rdrwo5fm6fcoufoih1vd4ls4j9jjpge16vfyxrc1l", "display-name": null, "id": "ocid1.volumeattachment.oc1.phx.abyhqlytoivg6eaybdrwb7mqqms6utjrefofrplyip7filf3vtpk55h2hzlq", "instance-id": "ocid1.instance.oc1.phx.abcdefgh6kykdowc8ozzvr4421kwp7apdrwk6wrjl7su82d60c6sp4nap88d", "ipv4": "169.254.2.2", "iqn": "iqn.2015-12.com.oracleiaas:e3fd73db-b164-4d76-bc3f-f58b093989d0", "lifecycle-state": "ATTACHED", "port": 3260, "time-created": "2017-08-26T00:51:30.462000+00:00", "volume-id": "ocid1.volume.oc1.phx.abyhqpa3ati7ggfjvba7y6dcg7imdrwskq4bdljroo2cbwchrebuprxddvca" } ] } }
-
Détachement du volume
volume-attachment-id
Pour détacher le volume (volume-attachment-id), exécutez la commande suivante.
oci compute volume-attachment detach --volume-attachment-id <volume_attachment_id>
Exemple de commande et réponseoci compute volume-attachment detach --volume-attachment-id ocid1.volumeattachment.oc1.phx.abyhqlytoivg6eaybdrwb7mqqms6utjrefofrplyip7filf3vtpk55h2hzlq
Toutes les actions destructives, telles que le détachement et la suppression de ressources, autorisent l'utilisation du paramètreAre you sure you want to delete this resource? [y/N]:
--force
, et la ressource est enlevée sans demande de confirmation. Il est recommandé d'appliquer l'option y/N plutôt que--force
.Confirmez la suppression. Aucune réponse n'est renvoyée après la suppression de la ressource.
-
Suppression du volume de blocs
Pour supprimer le volume de blocs, exécutez la commande suivante.
oci bv volume delete --volume-id <volume_id> --force
Exemple de commande et réponse-
oci bv volume delete --volume-id ocid1.volume.oc1.phx.abyhqljroo2cbwchrpa3ati7ggfjvba7y6dcg7imnleskq4bdebuprxddvca --force
Cette action n'entraîne aucune réponse. Pour vérifier que le volume de blocs a été supprimé, exécutez la commande suivante.
oci bv volume list -c <compartment_id>
La réponse à cette requête renvoie
"lifecycle-state": "TERMINATED"
, qui indique que le volume n'existe pas.
-
Pour supprimer le volume de blocs attaché à l'instance Windows, utilisez les étapes précédentes (1-3) pour vous guider.
Interruption des instances
Aide : oci compute instance terminate -h
Pour supprimer l'instance Linux, exécutez la commande suivante.
oci compute instance terminate --instance-id <instance_id>
oci compute instance terminate --instance-id ocid1.instance.oc1.phx.abcdefgh6kykdowc8ozzvr4421kwp7apdrwk6wrjl7su82d60c6sp4nap88d
Are you sure you want to delete this resource? [y/N]:
Confirmez la suppression. Aucune réponse n'est renvoyée après la suppression de l'instance.
Pour supprimer l'instance Windows, exécutez la commande suivante.
oci compute instance terminate --instance-id <instance_id>
oci compute instance terminate --instance-id ocid1.instance.oc1.phx.zsutzirph7cbrbx6rzu91stavdrw58puq3isknlr07zfcd6rq6p9
Are you sure you want to delete this resource? [y/N]:
Confirmez la suppression. Aucune réponse n'est renvoyée après la suppression de l'instance.
Suppression du réseau cloud virtuel
Aide : oci network subnet delete -h
, oci network vcn delete -h
Les 2 étapes suivantes sont nécessaires pour supprimer le réseau cloud virtuel.
-
Suppression du sous-réseau
Pour supprimer le sous-réseau, exécutez la commande suivante.
oci network subnet delete --subnet-id <subnet_id> --force
Exemple de commande et réponseoci network subnet delete --subnet-id ocid1.subnet.oc1.phx.aaaaaaaahvx05fhw7p320cxmdrwo5wlf50egig9cmdzs1plb1xl6c5wvb5s2 --force
Aucun
- Suppression du réseau cloud virtuel
Pour supprimer le réseau cloud virtuel, exécutez la commande suivante.
oci network vcn delete --vcn-id <vcn_id> --force
Exemple de commande et réponseoci network vcn delete --vcn-id ocid1.vcn.oc1.phx.aaaaaaaa6va8fxr1m4hvzjk3nzo8x290qymdrwiblxw5qpzlm64rdd74vchr --force
Aucun