Trigger PHP build & deploy pipeline

Automatic builds and deploys from GitHub or GitLab

Integrate Zerops to your GitHub or GitLab repository and configure the automatic builds and deploys.

Follow these steps:

1. Add zerops.yml to your repository.
2. Connect your GitHub repository or connect your GitLab repository

Then each time you create a new tag or push to a specific branch, depending on the configuration, GitHub or GitLab will initiate a new build & deploy pipeline.

Info

You can change the build and deploy pipeline when you need to. Just simply modify the zerops.yml in your repository.

Skip the automatic pipeline once

To ensure that a pipeline is not triggered by your next push, add [ci skip] or [skip ci] to the commit message. It is case insensitive.

Note

You will still see a successful delivery of a webhook in your Github/Gitlab repository as a webhook is actually triggered, but with no action.

Manual builds and deploys using Zerops CLI

To start a new build & deploy pipeline manually, use the Zerops CLI.

Follow these steps:

1. Add zerops.yml to your repository.
2. Install & setup zCLI the Zerops command line tool.
3. Run zcli push command.

The zcli push command uploads your application code, builds and deploys your application in Zerops.

The command triggers the build pipeline defined in zerops.yml. zerops.yml must be in the working directory. The working directory is by default the current directory and can be changed using the
--workingDir flag.

zCLI uploads all files and subdirectories of the working directory to Zerops and starts the build pipeline. If the .gitignore file is found, it is interpreted and the defined files and folders will be ignored.

If you just want to deploy your application to Zerops, use the zcli deploy command instead.

Push command parameters

Usage:
  zcli push [flags]

Flags:
      --archiveFilePath string   If set, zCLI creates a tar.gz archive with the application code in the required path relative
                                 to the working directory. By default, no archive is created.
      --deployGitFolder          If set, zCLI the .git folder is also uploaded. By default, the .git folder is ignored.
  -h, --help                     the service push command.
      --projectId string         If you have access to more than one project, you must specify the project ID for which the
                                 command is to be executed.
      --serviceId string         If you have access to more than one service, you must specify the service ID for which the
                                 command is to be executed.
      --versionName string       Adds a custom version name. Automatically filled if the VERSIONNAME environment variable exists.
      --workingDir string        Sets a custom working directory. Default working directory is the current directory. (default "./")
      --zeropsYamlPath string    Sets a custom path to the zerops.yml file relative to the working directory. By default zCLI
                                 looks for zerops.yml in the working directory.

zCLI commands are interactive, when you press enter after zcli push, you will be given a list of your projects to choose from.

Info

You can change the build and deploy pipeline when you need to. Just simply modify the zerops.yml in your repository.

Manual deploy using Zerops CLI

To start only a deploy pipeline, use the Zerops CLI.

Follow these steps:

1. Add zerops.yml to your repository. Omit the build section.
2. Install & setup zCLI the Zerops command line tool.
3. Run zcli service deploy command.

The zcli service deploy command uploads your application and deploys it in Zerops. Use this tool if you have your own build process. If you want to build your application in Zerops, use an automatic or manual build process.

Deploy command parameters

Usage:
  zcli service deploy pathToFileOrDir [flags]

Flags:
      --archiveFilePath string   If set, zCLI creates a tar.gz archive with the application code in the required path relative
                                 to the working directory. By default, no archive is created.
      --deployGitFolder          Sets a custom path to the zerops.yml file relative to the working directory. By default zCLI
                                 looks for zerops.yml in the working directory.
  -h, --help                     the service deploy command.
      --projectId string         If you have access to more than one project, you must specify the project ID for which the
                                 command is to be executed.
      --serviceId string         If you have access to more than one service, you must specify the service ID for which the
                                 command is to be executed.
      --versionName string       Adds a custom version name. Automatically filled if the VERSIONNAME environment variable exists.
      --workingDir string        Sets a custom working directory. Default working directory is the current directory. (default "./")
      --zeropsYamlPath string    Sets a custom path to the zerops.yml file relative to the working directory. By default zCLI
                                 looks for zerops.yml in the working directory.

pathToFileOrDir defines a path to one or more directories and/or files relative to the working directory. The working directory is by default the current directory and can be changed using the
--workingDir flag.

zerops.yml must be placed in the working directory.

Info

You can change the deploy pipeline when you need to. Just simply modify the zerops.yml in your working directory.