Stacktape

Sign up

Stacktape

Sign up



Deploying - using console

Prerequisites

To deploy a git project using Stacktape:

  1. You must have a Stacktape account. If you don't have an account, please sign up

  2. You must have an AWS account connected to your Stacktape organization. Connecting your account takes ~2 minutes. You can connect the account on AWS accounts page in the console

1 - Create new Stacktape project

After signing in to the console, click on Deploy new project and select Git project using console.

Create project
Create project

Fill in the Project name - this will be the name of your project in Stacktape. A project name must use a small alphanumeric dash case.

Fill in the project name
Fill in the project name

1.1 - Connect your Git repository

Option A - GitHub

Click the Connect GitHub Account button to start connecting your GitHub Account/Organization with Stacktape.

Connecting with GitHub
Connecting with GitHub

Click the Install button to start Stacktape GitHub app configuration.

Install GitHub app 1
Install GitHub app 1

Select GitHub organization.

Install GitHub app 2
Install GitHub app 2

Finish installation by clicking the Install button.

Install GitHub app 3
Install GitHub app 3

Option B - GitLab

Click the Connect GitLab Account button to start connecting your GitLab Account/Project with Stacktape.

Connecting with GitLab
Connecting with GitLab

Authorize application access to your GitLab account

Connecting with GitLab 2
Connecting with GitLab 2

1.2 - Select repository to deploy

After successfully connecting your git account, go back to project creation in Stacktape console.

Select the repository with the project you wish to deploy.

Select repository
Select repository

After you have finished the steps above, continue by clicking the Continue button.

Finish project setup
Finish project setup

2 - Deploy new stage

After you have created your project, you will be redirected to the project page.

Continue by clicking Create new stage button

Create new stage
Create new stage

2.1 - Configure stage details

Configure your environment details:

  1. Branch - branch to use for deployment,
  2. Commit - commit to use for initial deployment,
  3. Stage - arbitrary alphanumeric dash-case string. For example, production, staging or john-dev.
  4. AWS Account - select an AWS account connected to your Stacktape organization.
  5. If your repository does NOT contain a stacktape template (stacktape.yml or stacktape.ts), choose Create new infrastructure configuration.

Configuring environment details
Configuring environment details

2.2 - Create Stacktape configuration

  1. (Recommended) Use the interactive config editor. To learn about how to use it, head over to using the config editor.

  2. Use a starter projects with a pre-configured Stacktape configuration.

  3. Follow one of the step-by-step tutorials. Currenctly available tutorials are Fullstack Next.js T3 app and Web API.

  4. Write the config manually. To make this process easier, you can install Stacktape VScode extension.

2.3 - Deploy

When your template is ready, click on the Deploy now button.

Start the deployment
Start the deployment

After starting the deployment, you will be redirected to the deployment monitoring page, where you can see the deployment progress.

Deployment monitoring page
Deployment monitoring page

After deployment succeeds, you can redirect to the stack details page.

Stack overview page
Stack overview page

Previous

Under the hood

Next

Deploying using CLI

Need help? Ask a question on Discord or info@stacktape.com.