- Log in to the App Factory portal (for the online version, try https://appfactorypreview.wso2.com) as a user who is assigned the
Application Ownerrole or the
developerrole. Only these two user roles have permission to manage the source code and application versions. See roles/permissions list .
- Select an application from the list of apps that you own or are invited to participate in.
- The application opens. Click the Repos and Builds tab on the left panel.
- The Repositories and Builds page opens. It contains information of all versions of the application, which life-cycle stage each version is in and builds and deployment information of each version.
Click the browse icon associated with the trunk to open its repository URL in a separate window. This allows you to browse the files in the skeleton trunk created in the remote repository.
You are navigated to the repository. Log in with your App Factory credentials to see the repository files. For example, click the tree menu to see the folder structure as shown below:
NOTE: You must not perform any updates to the repository (for example, creating a branch) from the repository window. Those actions must happen from the App Factory portal to make sure the life cycle of the application is managed properly.
- Next, let's check out the remote trunk repository to your local environment. To do that, copy the trunk URL using the Copy URL icon associated with the trunk.
- Install the repository client (e.g., GIT client) in your local machine. (See http://git-scm.com/downloads/guis.)
Take a copy of the trunk repository to your local environment.
git clone <URL of the trunk>
- If you have already started developing the application, copy the contents of your existing application to the same folder that you cloned the trunk. Choose to replace any existing files such as the pom.xml.
- Change the following elements in the pom.xml file in your local folder:<groupId> : org.wso2.af<artifactId> : change to the existing app key<version> : SNAPSHOT
If you have resources associated with your application such a datasources, databases, endpoints, you must configure them before committing the source code to the trunk. See Configuring Resources.
Add, commit and push your changes to the remote repository.
git add <file or folder path> git commit -am "commit message" git push origin master
App Factory automatically builds and deploys your application every time a commit happens to the remote repository. To change this, see Auto build and deployment.