Launch Quick Start Guide with Gatsby
The fastest way to get started with Launch is to clone and deploy a sample Gatsby Starter project. Launch allows you to create a project by importing the website code from GitHub.
Voraussetzungen
- Contentstack -Konto
- Zugriff auf Launch für Ihre Organisation
- GitHub account
Schritte zur Ausführung
Follow the steps given below to deploy your first Launch project using GitHub:
- Log in to Contentstack und klicken Sie auf Start icon from the left navigation panel, as shown below:
- Click the + New Project button to initiate the project creation process.
- Von dem Create New Project modal, click Import from a Git Repository.
Note: You can also choose to upload a .zip file to import a project.
- Klicken GitHub.
Additional Resource: You can also import a project using Bitbucket Cloud. Follow the steps in the Create a Project Using Bitbucket Cloud guide to proceed.
A new page opens. Sign in or create a new GitHub account.
- Enter your credentials and log in.
- In the Repository Access section, select All repositories.
Note: If you want to choose specific repositories, select the Only select repositories option and choose the required repository.
- Drücke den Speichern Taste.
Note: If you are accessing GitHub through Contentstack for the first time, you must authorize Contentstack by clicking the Install & Authorize button after selecting All repositories.
You will be redirected to the Launch app.
-
In the Create New Project modal, add the following details:
- Repository (Mandatory): Select your Git repository.
- Git Branch (Mandatory): By default, master or main is selected as the branch. You can choose another branch from the dropdown.
- Project Name (Mandatory): Gets auto-populated on selecting the repository. You can edit it as per your requirement.
- Environment Name (Mandatory): Enter the name of the environment.
- Build and Output Settings (Mandatory): The fields in this section get auto-populated based on the detected framework.
- Umgebungsvariablen (Optional): Enter the key and value of one or more environment variables. For the Contentstack Gatsby Starter to work, we need to provide the following environment variables:
CONTENTSTACK_API_HOST=<api_host_value> CONTENTSTACK_APP_HOST=<app_host_value> CONTENTSTACK_API_KEY=<api_key_of_your_stack> CONTENTSTACK_DELIVERY_TOKEN=<delivery_token_of_the_environment> CONTENTSTACK_ENVIRONMENT=<environment_name> CONTENTSTACK_REGION=<region> CONTENTSTACK_BRANCH=<branch_name> CONTENTSTACK_MANAGEMENT_TOKEN=<mgmt_token> CONTENTSTACK_LIVE_PREVIEW=<true_or_false> CONTENTSTACK_LIVE_EDIT_TAGS=<true_or_false>
Note: Click Back to revert the changes and re-enter details.
- Once ready, click Einsetzen to save and deploy the project.
At first, the screen shows the Deploying status while the project deployment is in progress.
Upon successful deployment, you will see the following screen. You can preview the deployed website by clicking the icon next to the URL in the Domains section:
If you want to deploy the changes from any other commits, you can click the Redeploy button and choose the required commit.
Note: The log details of the current deployment can be found under the Logs section.