This action deploys a site to cPanel using the cPanel API, by taking the following steps:

1. Tell cPanel to pull the branch
2. Tell cPanel to deploy the branch
3. Poll cPanel deployment status, until the deployment task is complete

To make use of this action, your site should have a valid .cpanel.yml file at its root. More info about cPanel deployment can be found in the official documentation

Required hostname of cPanel installation, including protocol. for instance: https://hostname.example.com

Port of cPanel API. The default value is 2083 - don't change it unless you know what you're doing

cPanel API token, used for authorization. You should store this as a repository-secret.

cPanel username used for API calls. Must be the same username used to create the token. e.g: 'joe'

Required folder in which the repository is installed in the target cPanel account. must already exist. e.g: /home/your_account/repositories/your_repository

Required Whether or not to update the repository before triggering the deployment. If true - parameter 'branch' is required. defaults to true.

Required if updateRepository is true: branch to deploy. e.g: 'main' or 'master', or any other branch. Default: main

Duration of deployment, in milliseconds

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to cPanel
        id: deploy
        uses: pinkasey/cpanel-deploy-action@v1.0.0
        with:
          hostname: 'https://hostname.example.com'
          repository_root: '/home/my_account/repositories/my_repository'
          branch: main
          cpanel_token: '${{ secrets.CPANEL_TOKEN }}'
      - name: echo deploy-duration
        run: echo "Deployment took ${{ steps.deploy.outputs.duration }} milliseconds"