ServerKade

ServerKade

Did You Know?

Simplify server management and focus on your projects.

Git Integration

BitBucket | Product Documentation

Estimated reading: 5 minutes 23 views

Creating an application in ServerKade for hosting PHP scripts and projects with Git is simple. You can specify the application name, domain, system user, and other options such as PHP version and custom webroot. When choosing the deployment method, you can select “Git” to easily deploy your PHP code from a Git repository. Once the application is created, ServerKade will automatically clone the repository and deploy the code. You can manage the Git deployment process from the ServerKade dashboard. ServerKade makes it easy to create and manage PHP applications with Git.

Once you have connected your server with ServerKade, you can follow the steps below to install the Bitbucket repository on your server automatically.

Bitbucket integration

Step 1: First, you need to Integrate Git, Navigate to DashboardIntegrationGit.

Step 2: Click on the Bitbucket Link Bitbucket button like the image below. After that, authorize serverkade to deploy your project, and your Bitbucket account will be connected with serverkade.

Link Bitbucket

Step 3: Now, you can deploy a site from Bitbucket.

Create Application

Step 1: Click the server dashboard on which you want to create the new application.

Step 1

Step 2: Now, you will see the option Applications on the left-hand sidebar of the Server Panel. Click on Applications.

step 2

Step 3: Now, you will see the Applications table like the below image. Click on the Create button on the top right of the Applications table, as mentioned in the image below.

step 3

Step 4: After that, you will see the Create Application screen like the image below.

Application - Basic Details

Step 5: Basic Details

  • Enter the name of your application in the Application Name field.
  • Choose whether you want to use a primary domain or a test domain in the Domain field. If you select a test domain, you can change it later to a primary domain.

Application - Basic Details

Step 6: Application

After that, select Integrated Account, then select your repository Repository and choose the desired Branch. If you want to run a script after cloning your repository, then write a deployment script.

Step 7: Advance Options

When creating a new application in ServerKade, you have the option to either create a new system user for the application or use an existing one. A system user is a user account created on your server, which is used to manage files and permissions for your application.

In the Basic Settings section of creating an application in ServerKade, you have the option to select the PHP version for your application. ServerKade supports multiple PHP versions ranging from 7.2 to 8.3. You can choose the desired PHP version for your application.

Application - Settings

You also have the option to specify a custom webroot path for your application. By default, ServerKade sets the webroot path to /public_html for your application. However, if you want to set a custom webroot path, you can do so by entering the desired path in the “Webroot” field provided. This can be useful if you have specific requirements for the directory structure of your application.

If any changes are required, the user can go back to the respective sections and make the changes. If everything looks good, they can click on the “Create Application” button to create the application. your website must be live in next 10-15 seconds. Once your application is installed, you will be redirected to an application dashboard from which you can manage the application.

You can not perform Enable Auto Pull if your repository Type is public.

Step 8: If you want to Enable Auto Pull, then Navigate to Created Application DashboardGit.

  • Then click on Enable, as shown in the image below.

Application - enable

  • After that, Copy Webhook URL.
  • Login to your Integrated Bitbucket Account, and In your Selected Repository, navigate to Repository SettingsWebhooksAdd webhook, and use the following settings:
    • Title: Enter title
    • URL: Your Copied Webhook URL
    • Active: Check
    • SSL/TLS: Uncheck for Skip certificate verification
    • Triggers: Repository push
  • Click Save to save your settings, and the request should start working.
  • You can see your Request Logs as shown in the image below and click on Enable History.

Step 9: You can view your commit history in the Webhook History section.

Application - Git History

Step 10: If you want to Checkout branch, click on Change Branch aand select the branch you want to checkout.

Application - Bitbucket

Step 11: To Run Custom Script after a pull request, enter the script in the Deployment Script section and click Save.

Application - Bitbucket

  • If you want to run a Custom Script when the webhook receives a push request, you can write a script to perform the necessary commands in the Deployment Script section.

Please use # (hashtag) for comment in Deployment Script.

  • The script will run inside your application’s root folder. If your deployment script includes composer and PHP commands, it will use the default PHP-CLI. Use a replacer to run a script using a different PHP version.

    Replacer

    • The replacer allows you to specify a particular PHP version for the deployment script to use.
    • For example:
      {PHP70} artisan cache:clear
    • Will be translated to:
      /usr/bin/php7.0 artisan cache:clear
    • You can always type the full path to the PHP version if you don’t want to use the replacer.