Deploying - using console
Prerequisites
To deploy a git project using Stacktape:
You must have a Stacktape account. If you don't have an account, please sign up
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
.
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.
1.1 - Connect your Git repository
Option A - GitHub
Click the Connect GitHub Account
button to start connecting your GitHub Account/Organization with Stacktape.
Click the Install
button to start Stacktape GitHub app configuration.
Select GitHub organization.
Finish installation by clicking the Install
button.
Option B - GitLab
Click the Connect GitLab Account
button to start connecting your GitLab Account/Project with Stacktape.
Authorize application access to your GitLab account
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.
After you have finished the steps above, continue by clicking the Continue
button.
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
2.1 - Configure stage details
Configure your environment details:
- Branch - branch to use for deployment,
- Commit - commit to use for initial deployment,
- Stage - arbitrary alphanumeric dash-case string. For example,
production
,staging
orjohn-dev
. - AWS Account - select an AWS account connected to your Stacktape organization.
- If your repository does NOT contain a stacktape template (
stacktape.yml
orstacktape.ts
), choose Create new infrastructure configuration.
2.2 - Create Stacktape configuration
If you chose Create new infrastructure configuration in the previous step, this step will show the interactive config editor.
To write your configuration, you have 3 options:
- use the editor. To learn more about the editor, refer to interactive config editor guide
- re-use a configuration from one of the starter projects
- follow one of the tutorials: Fullstack Next.js T3 app or Web API
2.3 - Deploy
When your template is ready, click on the Deploy now
button.
After starting the deployment, you will be redirected to the deployment monitoring page, where you can see the deployment progress.
After deployment succeeds, you can redirect to the stack details page.