Getting Started

The State Tool offers a number of methods for simplifying and securing your Project configuration and integrating it with your development environment.

For information on installing the State Tool, see the installation guide.

This section outlines the steps you need to take to get up and running with the State Tool. The optional steps allow for advanced configuration of you development environment, but may not be necessary for simpler projects.

Use the following workflow to get started with the State Tool:

  1. Create your project - To work with the State Tool you need to create an ActiveState Platform project. You can specify the programming language to use, the software packages to include, and the operating systems to deploy the project to.
  2. Activate your runtime environment - When you run the state activate command, the State Tool creates an “activated” environment, which allows you to work in an isolated environment with the exact language runtime version and set of packages you need for your coding project.
  3. Configure constants and secrets (optional) - You can use constants to define any configuration information that’s repeated in your activestate.yaml file. The State Tool has a secret management solution built in for managing any confidential values required by your coding project.
  4. Configure scripts (optional) - Scripts enable you to run any logic required to configure or support your projects. You can run command line scripts specific to your operating system, or cross-platform Perl or Python scripts.
  5. Configure events (optional) - Events allow you to run commands or scripts each time the project is activated.