How to deploy an app from a public Git repository

Note: this tutorial uses Github as Git software but the same logic can be applied with any Git software like Bitbucket or Gitlabs. Some menu items can have different names.

The goal of this document: Describe the deployment of a public repository (WordPress in this example) on Qoddi.

You need :

1/ a Qoddi account
2/ a Github account

Clone the public repository

Qoddi requires language-specific files to be added to a repository before it can be built. Let’s fork the WordPress repository :

WordPress is a PHP app, we need to add an empty composer.json (with {} as contents) file first :

The presence of this composer.json file will inform the builder to select the PHP buildpack when building the app.

Depending on the language of your app you will need to add other language-specific files like packages.json for node apps or requirements.txt for Python app. Visit the language support section related to your app to know more.

Now, let’s create the app on Qoddi :

Since WordPress requires a MySQL database to run we selected MySQL 8x as a datastore.

Use direct Github Integration (Automatic mode)

Support : Github, Gitlab and Bitbucket

GitHub is integrated with Qoddi using OAuth, simply click on the Github button, select your repository and the branch you want to build, and validate :

The builder will immediately create a new build of your app from the repository you connected.

Note : A new build will be created each time you push new code on Github, to build your code on-demand only unselect the option “Auto build from Git push” from your app settings page.

Use SSH deploy key for unsupported or self hosted Git Platforms (Manual mode)

Copy the SSH address of your forked repository and the branch name from Github :

and paste it on FlashDrive :

Validate the total cost of the app and click Launch My App.

On the next screen copy the SSH key generated by Qoddi :

Click Settings > Deploy Keys on Github, click Add Deploy Key and paste the key from Qoddi :

Then click “Go to App settings” on Qoddi.

No app is deployed yet because the key was not added to Github when the builder tried to build the app after the app creation sequence was completed. You can see no app is deployed because the “Redeploy from registry” part is empty.

Click Pull and Build to build your app from Github :

Continue the installation procedure (for automatic or manual Git connection)

Wait for the builder to build your app and visit the URL of your app :

Congratulations, you successfully installed WordPress on Qoddi!

It’s not the purpose of this tutorial, but to continue the installation of WordPress it’s important to use a block storage solution like S3 to store the content dynamic content you add to your WordPress app (like images). This plugin does it automatically for you.

It’s also important to edit the wp-config.php and uses environment variables as credentials or your blog will be erased each time your app restart on Qoddi.

Was this helpful?

1 / 0