Versioning

Search…
Versioning
Overview
The bigger your system grows and the more libs or packages you integrate into your project, the more likely you are to face such a problem as dependency hell. 
As a solution, code.store platform suggests relying on a simple set of rules and requirements that govern how version numbers are assigned and incremented. There are many approaches to software versioning  and their interfaces, the choice is always up to the developer.
code.store platform doesn't enforce any standard on how you need to version your services, but we highly recommend looking at a standard like semver 
​semver's  approach can solve most of the versioning issues
When you create a new service, by default, it deployed into  private and demo environment and it's version is 0.0.1
Which version currently deployed?
To find out which version is in use execute cs service:info CLI command and select the service. You will find which versions deployed on private and demo environments.
> cs service:info
​
              Private                                                         Demo                                                            
version       0.0.2                                                           0.0.1                                                           
deployed      8/5/2020, 10:37:21 PM                                           8/5/2020, 10:38:58 PM                                           
developer key null                                                                                                                            
url           https://api.code.store/a6203d238a744492bf1bf33833c3ebf6/graphql https://api.code.store/a858e12ddd2c47f5b381bef9d98dc7a9/graphql 
On example above on the private environment deployed service with 0.0.2 version and 0.0.1 on the demo. 
If you already include service to project, you can execute cs project:service:info CLI command, select project and service to display.  
> cs project:service:info
​
              Development                                                     Staging                                                         Production                                                      
version       0.0.3                                                           0.0.2                                                           0.0.2                                                           
deployed      8/5/2020, 10:39:22 PM                                           8/5/2020, 10:39:23 PM                                           8/5/2020, 10:39:21 PM                                           
developer key                                                                                                                                                                                                 
url           https://api.code.store/8ddc603ea9dd4a669755bf2125bdca24/graphql https://api.code.store/bb2eae903e924bdeb3f6fe9627055d93/graphql https://api.code.store/efe4caaf5584497599728f3785e8fc7d/graphql 
On example above deployed on three environments deployed next versions:
environment
version
development
0.0.3
staging
0.0.2
production
0.0.2
Create a new service version
To create a new version just push your changes using cs push CLI command. More information about pushing changes can be found in Services section. After pushing changes - a new version will be available on the private environment.
It's very important to increment service version after making changes to service. Actual service version is always available at package.json file.
By default, code.store platform will automatically increment path (x.y.Z) version of your code after each push, if you follow semver specification. 
Publish a new service version
After creating a new service version using cs push command - changes will be available only on the private environment. 
demo environment - is the only place, where developed changes can be published. Changes from demo environment is available for including to the project or public access. 
To make a new version available - execute cs promote CLI command. This command will deploy changes from private to demo environment and makes a new version available for update/include into projects. Promoted version to demo environment is marks as LATEST
cs promote
Manage service version inside project
When you include a new service to the project - version from demo environment will be deployed. This allows adhering to the concept of public release of new versions to avoid unexpected system behavior. More information about including services to projects can be found in Projects section.
Move service version per environment
After including service to the project - it's deployed only to development environment. To move service version to another environment use cs project:service:promote CLI command. It allows you to move already deployed version to another environment.
cs project:service:promote
For example, if your project includes some service - you can promote only already deployed service version to another environments.
Update service version to latest
To update project service to latest version execute cs project:service:roll CLI command, where you can select project, environment where will be applied changes, service and version. 
Select latest version if you need a latest available service version.
cs project:service:roll
Rollback service version
To rollback service version use the same command cs project:service:roll and just select needed version and environment where to deploy needed version.
​
Projects
Access and Authorization
Last modified 1yr ago
Export as PDF
Copy link
Outline
Overview
Which version currently deployed?
Create a new service version
Publish a new service version
Manage service version inside project
Move service version per environment
Update service version to latest
Rollback service version