Création d'un projet

Dans un projetCollection d'artefacts qui définissent et gèrent les ressources et l'infrastructure en tant que déploiements de code. , vous pouvez ajouter des architectures déployables à partir du catalogue et modifier leur configuration. Le déploiement d'une configuration à partir d'un projet regroupe les ressources en fonction de la configuration que vous avez déployée.

Avant de commencer

Les ressources sont créées dans le compte du projet pour l'utilisateur. Vous devez disposer des autorisations nécessaires pour créer un projet et pour créer les ressources d'outils du projet dans le compte. Assurez-vous que vous disposez des accès suivants :

  • Le rôle d'éditeur sur le service IBM Cloud Projets.
  • Le rôle d'éditeur et de gestionnaire sur le service IBM Cloud® Schematics
  • Le rôle Viewer (Observateur) sur le groupe de ressources pour le projet

Pour plus d'informations sur l'accès et les autorisations, consultez la section Attribuer l'accès aux projets aux utilisateurs.

Ajouter des utilisateurs à un projet

L'accès au projet est contrôlé par IBM Cloud Identity and Access Management (IAM). Vous ajoutez des utilisateurs à un projet en leur attribuant le rôle Lecteur ou un rôle supérieur sur l'instance du projet. Pour plus d'informations sur l'attribution d'accès aux projets, consultez la section Attribuer des accès aux projets aux utilisateurs.

Création d'un projet à l'aide de la console

Vous pouvez créer un projet en accédant à l'icône Menu de navigation Menu de et en sélectionnant Projets ou à partir d'une architecture déployable dans le catalogue. Les projets peuvent également être créés à l'aide de l 'API Project.

Ajouter une architecture déployable à un projet à l'aide de la console

Les architectures déployables que vous ajoutez à un projet sont représentées sous forme de configurations dans l'interface utilisateur du projet. Après avoir ajouté une architecture déployable à un projet, vous pouvez modifier votre configuration avant de la déployer. Il existe plusieurs façons d'ajouter une architecture déployable à votre projet.

Pour ajouter une architecture déployable à votre projet à partir du tableau de bord du projet, procédez comme suit :

  1. Dans le tableau de bord du projet, sélectionnez l'onglet Configurations.
  2. Cliquez sur Créer.
  3. Sélectionnez une architecture déployable dans le catalogue.
  4. Cliquez sur Configurer et déployer.

Vous pouvez également ajouter une architecture déployable à un projet directement à partir du catalogue :

  1. Allez dans le Catalogue IBM Cloud.
  2. Sélectionnez l'architecture déployable.
  3. À partir de la liste du catalogue, vous pouvez créer un nouveau projet ou ajouter un élément à un projet existant.
  4. Cliquez sur Configurer et déployer.

Personnalisation d'une architecture déployable dans votre projet

Selon l'architecture déployable, vous pouvez la personnaliser lorsque vous l'ajoutez à un projet à partir d'un catalogue. Les options suivantes s'offrent à vous :

  • Ajoutez des architectures déployables en option pour étendre la solution à un cas d'utilisation particulier.
  • Remplacer une architecture par une autre. Par exemple, si plusieurs options de base de données sont proposées, vous pouvez sélectionner celle que vous souhaitez utiliser.
  • Sélectionnez une configuration existante d'une architecture dans votre projet afin de la réutiliser avec l'architecture que vous ajoutez. Ce faisant, vous pouvez réduire les coûts et réutiliser le même déploiement pour plusieurs architectures.

Dans la section Étendre cette architecture du catalogue, cliquez sur Personnaliser pour affiner votre architecture avant de la configurer et de la déployer. Si l'option Personnaliser n'est pas disponible dans la liste du catalogue pour l'architecture déployable, vous pouvez toujours configurer l'architecture et la personnaliser en empilant d'autres architectures déployables avec celle-ci dans votre projet.

Après avoir effectué vos sélections et ajouté l'architecture déployable à votre projet, vous pouvez la personnaliser davantage en sélectionnant l'icône OptionsIcône > Personnaliser l'architecture dans l'onglet Configurations. À partir de là, vous pouvez ajouter d'autres architectures déployables compatibles pour personnaliser davantage la solution.

Pour sauvegarder les informations du projet en dehors du service IBM Cloud Projets, vous pouvez exporter le projet. Pour plus d'informations, rendez-vous sur Project JSON.

Consultez les étapes à suivre pour configurer et déployer une architecture déployable lorsque vous êtes prêt à déployer des ressources à partir d'une architecture déployable d'un projet.

Création d'un projet à l'aide de l'interface de programmation

Pour créer un projet à l'aide de l'interface CLI, exécutez la commande ibmcloud project create suivante :

ibmcloud project create [--definition DEFINITION | --definition-name DEFINITION-NAME --definition-destroy-on-delete=DEFINITION-DESTROY-ON-DELETE --definition-description DEFINITION-DESCRIPTION --definition-auto-deploy=DEFINITION-AUTO-DEPLOY --definition-monitoring-enabled=DEFINITION-MONITORING-ENABLED] --location LOCATION --resource-group RESOURCE-GROUP [--configs CONFIGS] [--environments ENVIRONMENTS]

Voir ibmcloud project create pour un exemple de commande et plus d'informations sur les paramètres de commande.

Ajouter une architecture déployable à un projet à l'aide de l'interface CLI

Pour ajouter une architecture déployable à votre projet à l'aide de l'interface CLI, exécutez la commande ibmcloud project config-create suivante :

ibmcloud project config-create --project-id PROJECT-ID [--definition DEFINITION | --definition-compliance-profile DEFINITION-COMPLIANCE-PROFILE --definition-locator-id DEFINITION-LOCATOR-ID --definition-description DEFINITION-DESCRIPTION --definition-name DEFINITION-NAME --definition-environment-id DEFINITION-ENVIRONMENT-ID --definition-authorizations DEFINITION-AUTHORIZATIONS --definition-inputs DEFINITION-INPUTS --definition-settings DEFINITION-SETTINGS --definition-members DEFINITION-MEMBERS --definition-resource-crns DEFINITION-RESOURCE-CRNS] [--schematics SCHEMATICS | --schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN]

Voir ibmcloud project config-create pour un exemple de commande et plus d'informations sur les paramètres de commande.

Pour sauvegarder les informations du projet en dehors du service IBM Cloud Projets, vous pouvez exporter le projet. Pour plus d'informations, rendez-vous sur Project JSON.

Créer un projet en utilisant l'API

Vous pouvez créer un projet par programme en appelant l'API Projets, comme le montre l'exemple de requête suivant :

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{ "definition": { "name": "acme-microservice", "description": "A microservice to deploy on top of ACME infrastructure.", "authorizations": { "method": "trusted_profile", "trusted_profile_id": "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12" } }, "configs": [ { "definition": { "name": "account-stage", "description": "The stage account configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "env-stage", "description": "The stage environment configuration that includes services common to all the environment regions.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "The name of the LogDNA stage service instance.", "sysdig_name": "The name of the SysDig stage service instance." } } }, { "definition": { "name": "region-us-south-stage", "description": "The stage us-south configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "region-eu-de-stage", "description": "The stage eu-de configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "ref:/configs/env-stage/outputs/resource_group_id", "logdna_id": "ref:/configs/env-stage/outputs/logdna_id", "sysdig_id": "ref:/configs/env-stage/outputs/sysdig_id", "access_tags": [ "region:eu-de" ] } } } ], "location": "us-south", "resource_group": "Default" }' \
  "{base_url}/v1/projects"

Ajouter une architecture déployable à un projet à l'aide de l'API

Vous pouvez ajouter par programmation une architecture déployable à un projet existant en appelant l 'API Projects et en personnalisant la configuration comme indiqué dans l'exemple de requête suivant :

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
   --header "Accept: application/json" \
   --header "Content-Type: application/json" \
   --data '{ "definition": { "name": "env-stage", "description": "The stage environment configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "LogDNA_stage_service", "sysdig_name": "SysDig_stage_service" } } }' \
   "{base_url}/v1/projects/{project_id}/configs"

Pour sauvegarder les informations du projet en dehors du service IBM Cloud Projets, vous pouvez exporter le projet. Pour plus d'informations, rendez-vous sur Project JSON.