You should skip setting up infrastructure in the following situations:
- You want to run your projects only locally for now.
- Your organization is already using Taito CLI. In such case you should use the existing infrastructure, and ask for taito configuration settings from your colleagues and copy-paste the settings to your
- You already have an existing infrastructure, but no Taito CLI configurations for it. In such case, you should execute the following steps, but skip the step 2.
You can create a new zone with the following steps:
Create a new zone configuration based on one of the infrastructure templates. For example:
taito zone create gcp cd my-zone EDIT taito-config.sh
Apply infrastructure configuration by running the following command, and follow instructions. This creates you a zone; typically consisting of a Kubernetes cluster, database clusters, object storage buckets, container registry, virtual private network, and some settings related to logging, monitoring, and IAM.
taito auth taito zone apply
TIP: If you encounter an error while running Terrafom, just try to run
taito zone applyagain.
View the created resources on your cloud provider dashboard:
taito open dashboard
RECOMMENDATION: Use the dashboard for viewing only. If you need to make changes to the infrastructure, make changes to the zone configuration files, and run
taito zone applyto apply the changes. This way you can keep all your infrastructure configurations in version history (infrastructure as code).
Commit your zone configuration files to some git repository.
RECOMMENDATION: Create one git repository for all of your zones, and give write permission for DevOps personnel only.
Display project template settings with
taito project settings and copy-paste the settings to your
~/.taito/taito-config.sh file. You'll need these settings when you create a new project for the zone.
taito -q project settings >> ~/.taito/taito-config.sh
TIP: Your default configuration is located in
~/.taito/taito-config.sh. You can also have additional configurations, e.g.
Create a new project based on one of the project templates. For example:
taito project create full-stack-template cd acme-myproject
TIP: You can choose some other than default configuration with
-o, for example:
taito -o company-x project create full-stack-template.
Clean start the local development environment with the following command. This typically initializes your local secrets, installs some libraries, builds and starts containers, and initializes your database with tables and some data. Secret default values are typically copied from dev environment, if available.
In case of trouble, run
taito trouble. Sometimes
taito developmight fail and hopefully
Open application web UI on your browser:
taito open client
Connect to the database:
taito db connect
If you skipped the setting up infrastructure part before, now is the right time to create the zone, and to update your project with the correct settings by running
taito project upgrade.
View organization specific conventions, and follow instructions:
taito open conventions
Apply project wide settings:
taito project apply
Make sure your authentication is in effect:
Create dev environment with the following command. This typically creates a database and some cloud resources (e.g. storage buckets), initializes secrets, and sets up the CI/CD pipeline.
taito env apply:dev
Trigger the first CI/CD deployment by committing and pushing changes to dev branch (you can do this with git tools also). Note that you should write your commit message according to Conventional Commits:
taito stage # Or just: git add . taito commit # Or just: git commit -m 'chore: configuration' taito push # Or just: git push
Show build status on browser:
taito open builds:dev
Show status of dev environment:
Open application web UI running on dev environment:
taito open client:dev
Show credentials for signing in (basic auth):
Tail logs of server container running on dev environment:
Initialize dev environment database with some development data:
Connect to the dev environment database:
taito db connect:dev
Make sure your authentication is in effect:
Create production environment:
taito env apply:prod
Merge changes between environments:
dev -> ... -> prod (you can do this with git tools also, but always use fast-forward when merging between environment branches):
taito env merge:dev prod
Show production environment build status on browser:
taito open builds:prod
Open application web UI running on prod environment:
taito open client:prod
Show release notes for the first production release you just made:
taito open releases
Semantic-release library requires version control personal access token (GitHub/GitLab/BitBucket) for accessing the version control API. Release notes will be generated only if you configured the token during the zone creation, or you configured VC_TOKEN environment variable for your CI/CD pipeline.
taito -h to show more taito commands that you can use, or see the help.txt. Check also the DEVELOPMENT.md file located at your project root folder.
Next: 4. Usage