Import application or application-customization from source control

Import an app or app customization from a source control repository into App Engine Studio (AES) to continue developing it on this instance.

Before you begin

• Role required: admin
• Verify that the non-production instance has network access to the Git repository.
• Verify that the repository contains a valid application.
• Ensure that users add the email address to their respective Users table [sys_user] record that they use in their commits to the Git repository.
• Learn more about application-customizations Manage customizations to applications.

About this task

The source control integration does not support importing an application on a production instance. Instead install applications on a production instance from the application repository, an update set, or the App Engine Studio.

Procedure

1. Navigate to All > App Engine > App Engine Studio.
2. Select Import app.
   
3. On the form, fill in the fields.

   Table 1. Import from source control fields

   Field	Description
   Network protocol	Https or ssh credential type that enables secure channel data exchange.
   URL	The URL to the Git repository where the application files reside. Note: If the Git repo URL for SSH provided by your Git server does not work, check with your Git server owner or provider for the correct URL. There may be additional specifications such as scheme protocol prefixes, port numbers, and so on, required for your Git repo URL to function.
   Branch	The repository branch to work on within the application. Note: The default branch is named after your instance. If you do not choose a name, the branch defaults to master.
   MID Server Name	Select an existing MID Server to link to a Git repository stored behind your corporate firewall. Note: Use a separate MID Server to prevent conflicts with Discovery activities. See MID Server for more information.
   Default email	The committer email address is defined by the sys_user record if available. But if a committer's sys_user record email field is empty, the system generates an alternate email ([e-mail]). You can also enter a default email address and change it later. To use that default email address in all cases, select the check box.
   Credential	Select the credential for your Git repository. For more information, see Getting started with Credentials. Note: If you select the ssh network protocol, enter a valid credential of the SSH Private Key type. If you select the https protocol, enter a valid credential of the Basic Auth Credentials type.

   Note:

   All application developers on the instance share the credential used to link a Git repository to an application.
4. Select Import app.
   The system compares the checksum in the checksum.txt file to current checksum. When the checksum values match, the integration skips validation and imports the application. When the checksum values do not match, the integration first validates and sanitizes the application files before importing them.
5. Select Select Application.
   App Engine Studio displays the application as a new choice in the Switch Applications window.

What to do next

• Review the upgrade logs for any sanitization applied to application files during the import.
• Select the imported application to edit it.

Related topics

• MID Server
• Getting started with credentials