Creación de un proyecto

En un proyectoColección de artefactos que definen y gestionan recursos e infraestructura como despliegues de código. , puede añadir arquitecturas implementables del catálogo y editar su configuración. Al implementar una configuración desde un proyecto, se agrupan los recursos en función de la configuración que se ha implementado.

Antes de empezar

Los recursos se crean en la cuenta del proyecto para el usuario. Debe tener permiso para crear un proyecto y permiso para crear los recursos de herramientas del proyecto dentro de la cuenta. Asegúrese de que dispone de los siguientes accesos:

  • La función de Editor en el servicio IBM Cloud Proyectos.
  • La función de editor y administrador en el servicio IBM Cloud® Schematics
  • El rol de espectador en el grupo de recursos para el proyecto

Para obtener más información sobre el acceso y los permisos, consulte Asignación de acceso a proyectos a los usuarios.

Añadir usuarios a un proyecto

El acceso al proyecto está controlado por un sistema de gestión de identidades y accesos ( IBM Cloud, IAM). Identity and Access Management Para añadir usuarios a un proyecto, hay que concederles el rol de lector o superior en la instancia del proyecto. Para obtener más información sobre cómo asignar acceso a proyectos, consulte Asignar acceso a proyectos a los usuarios.

Creación de un proyecto mediante la consola

Puede crear un proyecto accediendo al icono del menú de navegación Icono y seleccionando Proyectos o desde una arquitectura implementable en el catálogo. Los proyectos también se pueden crear utilizando la API del proyecto.

Añadir una arquitectura implementable a un proyecto mediante la consola

Las arquitecturas implementables que se añaden a un proyecto se representan como configuraciones en la interfaz de usuario del proyecto. Después de añadir una arquitectura implementable a un proyecto, puede editar su configuración antes de implementarla. Hay varias formas de añadir una arquitectura implementable a tu proyecto.

Para añadir una arquitectura implementable a tu proyecto desde el panel de control del proyecto, sigue estos pasos:

  1. En el panel de control del proyecto, seleccione la pestaña Configuraciones.
  2. Pulse Crear.
  3. Seleccione una arquitectura implementable del catálogo.
  4. Haga clic en Configurar y desplegar.

También puede añadir una arquitectura implementable a un proyecto directamente desde el catálogo:

  1. Vaya al Catálogo de IBM Cloud.
  2. Seleccione la arquitectura implementable.
  3. Desde el listado del catálogo, puede crear un nuevo proyecto o añadirlo a uno ya existente.
  4. Haga clic en Configurar y desplegar.

Personalización de una arquitectura implementable en su proyecto

Dependiendo de la arquitectura desplegable, es posible que puedas personalizarla cuando la añadas a un proyecto desde un catálogo. Puede tener las siguientes opciones:

  • Añada arquitecturas desplegables opcionales para ampliar la solución para un caso de uso concreto.
  • Cambiar una arquitectura por otra. Por ejemplo, si se proporcionan varias opciones de bases de datos, puede seleccionar la que desee utilizar.
  • Seleccione una configuración existente de una arquitectura en su proyecto para reutilizarla con la arquitectura que está añadiendo. De este modo, puede reducir costes y reutilizar la misma implementación para múltiples arquitecturas.

En la sección Ampliar esta arquitectura del catálogo, haga clic en Personalizar para perfeccionar su arquitectura antes de configurarla e implementarla. Si la opción Personalizar no está disponible en la lista del catálogo para la arquitectura implementable, aún puede configurar la arquitectura y personalizarla apilando otras arquitecturas implementables con ella en su proyecto.

Después de realizar sus selecciones y añadir la arquitectura implementable a su proyecto, puede personalizarla aún más seleccionando el Opciones icono Icono > Personalizar la arquitectura en la pestaña Configuraciones. Desde allí, puede añadir otras arquitecturas desplegables compatibles para personalizar aún más la solución.

Para realizar una copia de seguridad de la información del proyecto fuera del servicio Proyectos de IBM Cloud, puede exportar el proyecto. Para obtener más información, visite Project JSON.

Consulte los pasos para configurar e implementar una arquitectura implementable cuando esté listo para implementar recursos desde una arquitectura implementable de un proyecto.

Creación de un proyecto mediante la CLI

Para crear un proyecto utilizando la CLI, ejecute el siguiente ibmcloud project create comando :

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]

Consulte ibmcloud project create para ver un ejemplo comando y obtener más información sobre los parámetros comando.

Añadir arquitectura implementable a un proyecto mediante la CLI

Para añadir una arquitectura implementable a su proyecto mediante la CLI, ejecute el siguiente ibmcloud project config-create comando :

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]

Consulte ibmcloud project config-create para ver un ejemplo comando y obtener más información sobre los parámetros comando.

Para realizar una copia de seguridad de la información del proyecto fuera del servicio Proyectos de IBM Cloud, puede exportar el proyecto. Para obtener más información, visite Project JSON.

Creación de un proyecto mediante la API

Puede crear un proyecto mediante programación llamando a la API de proyectos, como se muestra en la siguiente solicitud de ejemplo:

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"

Añadir una arquitectura implementable a un proyecto mediante el uso de la API

Puede añadir mediante programación una arquitectura implementable a un proyecto existente llamando a la API de proyectos y personalizando la configuración como se muestra en la siguiente solicitud de ejemplo:

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"

Para realizar una copia de seguridad de la información del proyecto fuera del servicio Proyectos de IBM Cloud, puede exportar el proyecto. Para obtener más información, visite Project JSON.