Initiation à l'interface de ligne de commande Code Engine

Vous pouvez utiliser l'API IBM Cloud® Code Engine pour créer et gérer vos entités Code Engine.

Configuration de votre environnement CLI

Pour utiliser l'interface de ligne de commande afin de créer et de gérer des entités Code Engine, configurez votre environnement d'interface de ligne de commande. Assurez-vous que la dernière version de l'interface de ligne de commande (CLI) d' IBM Cloud est bien installée.

Avant de commencer

Vous devez créer un compteIBM Cloud.

  1. Téléchargez et installez l'interface de ligne de commande IBM Cloud.

  2. Connectez-vous à l'interface de ligne de commande IBM Cloud.

    1. Connectez-vous à l'interface de ligne de commande IBM Cloud.
        ibmcloud login
    ```
2. Si vous possédez plusieurs comptes, vous êtes invité à sélectionner celui que vous souhaitez utiliser. Suivez les invites ou utilisez la commande **`target`** pour sélectionner votre compte IBM Cloud.

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. Indiquez une région. Utilisez la **`target`** commande pour sélectionner ou modifier des zones.

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. Indiquez un groupe de ressources. Pour obtenir la liste de vos groupes de ressources, exécutez la commande suivante :

```txt {: pre}
    ibmcloud resource groups
    ```
    Exemple de sortie

    ```txt {: screen}
    Retrieving all resource groups under account <account_id> as email@ibm.com...
    OK
    Name      ID                                 Default Group   State   
    default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
    test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE
    ```
5. Ciblez un groupe de ressources en exécutant la commande suivante :

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    Exemple de sortie

    ```txt {: screen}
    Targeted resource group default
    ```

  3. Installez le plug-in d'interface de ligne de commande Code Engine.

    ibmcloud plugin install code-engine

  4. Vérifiez que le plug-in CLI « Code Engine » est bien installé. Vous pouvez utiliser la commande ibmcloud code-engine version ou la commande ibmcloud plugin list pour confirmer que le plug-in est installé.

    ibmcloud code-engine version

    Exemple de sortie

    OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d

  5. Exécutez la commande ibmcloud ce help pour afficher les commandes de l'interface de ligne de commande Code Engine. Par exemple :

    ibmcloud ce help

Utilisation de l'interface de ligne de commande Code Engine

Maintenant que votre environnement d'interface de ligne de commande Code Engine est configuré, vous êtes prêt à utiliser des ressources Code Engine, telles que des applications, des fonctions ou des travaux avec l'interface de ligne de commande.

Avant de pouvoir utiliser des ressources Code Engine, vous devez travailler dans le contexte d'un projet.

Un projet est un ensemble d'entités d' Code Engine, telles que des applications, des fonctions, des tâches, des parcs et des versions. Un projet est basé sur un espace de nom Kubernetes. Le nom de votre projet doit être unique au sein de votre groupe de ressources, compte utilisateur et région IBM Cloud®. Les projets servent à gérer les ressources et à permettre l'accès à leurs entités.

Un projet offre les fonctionnalités suivantes :

  • Un espace de noms unique pour les noms d'entités.
  • Gestion des accès entrants aux ressources du projet.
  • Gestion des accès sortants aux services de sauvegarde, aux registres et aux référentiels.
  • Certificat généré automatiquement pour le service de la couche de transport ( TLS ).

Pour plus d'informations sur les projets Code Engine, voir Gestion des projets.

  1. Créez un projet à l'aide de la commande project create. Utilisez un nom de projet unique dans votre région.

    ibmcloud ce project create --name PROJECT_NAME

    Exemple de sortie

    Creating project 'myproject'...
OK

  2. Affichez les détails du projet à l'aide de la commande project get.

    ibmcloud ce project get --name PROJECT_NAME

    Exemple de sortie

    Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

Vous pouvez également utiliser la commande project list pour afficher la liste des projets que vous avez créés.

Pour utiliser un projet depuis l'interface de ligne de commande, le projet doit être sélectionné comme contexte actuel. Un projet est automatiquement sélectionné comme contexte actuel quand il est créé, sauf si vous spécifiez l'option --no-select. Pour sélectionner un projet qui n'est pas ciblé actuellement, utilisez la commande project select.

Pour plus d'informations sur l'utilisation des projets, voir Gestion des projets.

Etapes suivantes

Maintenant que vous avez configuré votre environnement d'interface de ligne de commande et que vous avez effectué les premières étapes pour vous assurer que vous travaillez dans le contexte d'un projet Code Engine, vous pouvez utiliser l'interface de ligne de commande Code Engine pour utiliser des applications, des fonctions et des travaux.

Pour commencer à utiliser les composants Code Engine avec l'interface de ligne de commande, voir les rubriques suivantes.

Pour plus d'informations sur l'interface de ligne de commande Code Engine, voir Configuration de l'environnement de l'interface de ligne de commande.

Pour plus d'informations sur l'utilisation de l'environnement de l'interface de ligne de commande Code Engine, voir la documentation de référence des commandes de l'interface de ligne de commandeCode Engine.

Pour un récapitulatif des modifications apportées à chaque version de l'interface de ligne de commande, voir Historique des versions de l'interface de ligne de commande. Assurez-vous de tenir votre interface de ligne de commande à jour afin que vous puissiez utiliser toutes les commandes disponibles et leurs options.