cs-icon.svg

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

  1. Contentstack -Konto
  2. Zugriff auf Launch für Ihre Organisation
  3. GitHub account

Schritte zur Ausführung

Follow the steps given below to deploy your first Launch project using GitHub:

Note: Only the Organization Admin/Owner has the right to create projects in a stack for Launch.

  1. Log in to Contentstack und klicken Sie auf Start icon from the left navigation panel, as shown below:
    Launch_New_LeftNav_Hover.png
  2. Click the + New Project button to initiate the project creation process. Launch_Landing_Page_Update_SearchBar_Click.png
  3. Von dem Create New Project modal, click Import from a Git Repository.
    Launch_Create_Proj_Git_File.png

    Note: You can also choose to upload a .zip file to import a project.

  4. Klicken GitHub.

    Launch-GitHub-ConnectAccount.png

    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.

  5. Enter your credentials and log in.

    Launch-Sign-In.png

  6. 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.

    Launch_New_Repository_Access_SS.png

  7. 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.

    Launch-GitHub-Install_Authorize.png

    You will be redirected to the Launch app.

  8. In the Create New Project modal, add the following details:

    1. Repository (Mandatory): Select your Git repository.
    2. Git Branch (Mandatory): By default, master or main is selected as the branch. You can choose another branch from the dropdown.
    3. Project Name (Mandatory): Gets auto-populated on selecting the repository. You can edit it as per your requirement.
    4. Environment Name (Mandatory): Enter the name of the environment.
    5. Build and Output Settings (Mandatory): The fields in this section get auto-populated based on the detected framework. Launch_QuickStart_Gatsby_CreateNewProj_Modal1
    6. 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>
      
      Launch_QuickStart_Gatsby_CreateNewProj_Modal2

      Note: Click Back to revert the changes and re-enter details.

  9. 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.

    Launch_QSGatsby_Deploying.png

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:

Launch_QSGatsby_Deployed.png

If you want to deploy the changes from any other commits, you can click the Redeploy button and choose the required commit.

Launch_QSGatsby_Redeploy.png

Note: The log details of the current deployment can be found under the Logs section.

Launch_QSGatsby_Logs.png

War dieser Artikel hilfreich?
^