Projects
Overview
Projects are the essence of the code.store platform, which has the ability to contain many services.
Projects serve as an isolated environment for services groups. Any project can contain one or more services, and available within the organization the user belongs to.
In order for the service to be publicly available, it must be included in the project, since the code.store platform guarantees high availability and scalability only in a production environment. For more information about environments, see the Environments section.
Create a new project
In order to create a new project, you need to execute cs project:create
command and provide information about your service. Below an example of cs project:create
command execution:
Successful result of the command execution will be:
After successful project creation, an access key to the development and staging environments will be issued in the command output. Information about authorization using the provided key can be found in Access and Authorization section.
When creating a new project, by default, the code.store platform will create three environments: development, staging, and production. For more information about environments, see the Environments section.
Let's make sure that the project has been created by running the cs project:list
command.
Project ID
displays ids of all projects that available for user. Please, note, that ID is lowercase.
Services
count of included to project services.
Author
email of the project creator.
Description
description, which user set, when creating a project.
After creating a project, it will be available to all members of the organization to which the user belongs.
Include service to project
By default, there are no services in the project. To add a new service to the project just execute cs project:service:add
command with two arguments: projectID - where service should be included and serviceID - id of service, which will be included.
For example, let's include service demo_app to the my_project project:
Will be included version of the service from the demo environment.
After command execution, the service is being to deploy to the development project environment.
To monitor service deployment status just execute cs project:service:info
command and select the project and service.
cs project:service:info
command output will display environments, where service is deployed (in our case service just added to project and deployed only to development environment), deployed service version, developer key, and the service URL.
Promote service
After adding a new service to the project, it becomes necessary to deploy it not only to development but also to staging and production environments.
To promote service per environments available cs project:service:promote
command. After command execution, you will be able to select the project, service which already included into the selected project and environment, where service should be deployed.
In the example above, we promote service with ID: demo_app, which already included to project with ID: my_project to the staging environment.
Using this approach, you can deploy the service to a production environment.
Update service version
To update service version just re-use cs project:service:promote
command.
Note, after command execution version from the demo environment will be applied.
It is necessary that the service was previously updated on the demo environment. For more information about environments, see the Services section. About versioning see the Versioning section.
Exclude service from project
Delete project
Last updated