Creating a Git Repository for Artifact Distribution

Prior to subscribing to a cartridge, you have to create a remote Git repository in GitHub to store your artifacts. The Git repository folder structure will vary based on the respective WSO2 cartridge. Therefore, it is very important that you create the Git folder structure accurately.

The Git repository folder structure for the various WSO2 cartridges that are available in WSO2 Private PaaS are as follows:

You do not need to create a folder structure for WSO2 API Manager (AM) as users do not need to provide existing artifacts, because the artifact creation process happens in the publisher node. However, as artifact synchronization needs to take place in the Gateway nodes, you need to provide the artifact repository details at application signup for multitenant applications, and in the application definition JSON for single tenant applications.

To get the respective Git repository folder structure for WSO2 products follow the instructions below:

Download the WSO2 product pack that corresponds to the WSO2 application that you wish to deploy.
Unzip the downloaded binary pack.
Start the downloaded WSO2 product server.
Create a tenant via the respective WSO2 product management console.
1. Sign into the respective WSO2 product management console via one of the following URLs. Use admin as the username and password:
  - For access via HTTP: http://<HTTP_HOST>:<HTTP_PORT>/admin/carbon/ For example:http://localhost:9763/admin/carbon/
  - For access via secured HTTP:
    https://<HTTPS_HOST>:<HTTPS_PORT>/admin/carbon/ For example:https://localhost:9443/admin/carbon/
2. On the Configure tab of the Management Console, click Add New Tenant.
3. Enter the required details as follows:
  - Domain - The domain name for the organization, which should be a unique name (e.g., abc.com).
  - Usage plan for the tenant - The usage plan defines limitations (such as number of users) for the tenant.
  - First Name - First name of the tenant admin.
  - Last Name - Last name of the tenant admin.
  - Admin Username - The username the tenant admin will use to log in. The username must always end with the domain name (e.g., admin@abc.com).
  - Email - The email address of the admin.
4. Click Save.
5. Sign out of the WSO2 product management console.
Sign into the WSO2 product management console using the newly created tenant credentials.
Navigate to the <PRODUCT_HOME>/repository/tenant/<TENANT_ID> directory.
cd <PRODUCT_HOME>/repository/tenant/<TENANT_ID>
Copy the content in the latter mentioned folder recursively to the local Git repository root folder.

You need to copy the folder structure in this manner as there are default configurations that are needed, e.g., In WSO2 ESB, there are module meta files, which are used to configure properties related to modules, such as, Rampart and Rahas.
Commit the changes and push it to the Git repository.