Code-Hero: 4. Create the service

This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start Code-Hero, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero offers Code-Hero, a complete development platform to code in seconds:

• Code from anywhere: Use any device, be it a desktop, phone, or tablet, without requiring any software installations.
• Integrated VSCode experience: Work with a customized version of VSCode directly through your browser, featuring a fully functional terminal.
• Comprehensive toolset: Benefit from a pre-configured environment with tools and languages like Docker, Git, Zsh, Node.js, Go, Python, Ruby, and more.
• Seamless connectivity: Access your development applications via HTTPS on a public domain, mimicking production conditions. This setup supports webhooks and external integrations effortlessly.

Experience the efficiency and convenience of Stackhero's Code-Hero development cloud solution. It takes just 5 minutes to get started! Simplify your development processes and save valuable time today.

Below is a sample script that creates a stack, adds your Code-Hero service to it, waits for it to start, retrieves its configuration (including generated credentials), and then applies a new configuration.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="code-hero"   # The Code-Hero service store name (see step 2)
instance="..."                # An instance size from step 3
region="europe"               # A region name from step 3

# Create a stack for your service (uses your default organization; add --organization if needed)
stackId=$(stackhero --format=script stack-create \
  --name="My Code-Hero stack")
echo "Stack created: ${stackId}"

# Add Code-Hero to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
  --stack="My Code-Hero stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: code-hero"

# Wait for the service to be fully operational (this may take a few minutes)
stackhero service-wait-for --service="code-hero"

# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="code-hero" --format=json