PHP build process
Description of the build process​
Zerops starts a temporary build container and performs following actions:
- Installs the build environment
- Downloads your application source code from GitHub ↗, GitLab ↗ or via Zerops CLI
- Optionally customises the build environment
- Runs the build commands
- Uploads the application artefact to the internal Zerops storage
- Optionally customizes the runtime environment
- Deploys your application
The build container is automatically deleted after the build has finished or failed.
Cancel running build​
When you know that the running build is not correct and you want to cancel it, you can do it in Zerops GUI. Go to the service detail, select Service dashboard & runtime containers from the left menu and click on the Open pipeline detail button. Then click on the Cancel build button.
// TODO screenshot of a running build pipeline
The build cancellation is available before the build pipeline is finished. When the build is finished, the deployment cannot be cancelled.
Customise PHP build environment​
The default PHP build environment contains:
- Alpine 3.19
- selected version of PHP defined in
zerops.yml
build.base parameter - zCLI, Zerops command line tool
composer
,git
andwget
.
If you prefer the Ubuntu OS instead of Alpine, set the <a href="/php/how-to/build-pipeline#os">build.os</a>
attribute to ubuntu
. To install additional packages or tools add one or more build.prepareCommands commands to your zerops.yml
.
The application code is available in the /var/www
folder in your build container before the prepare commands are triggered. This allows you to use any file from your application code in your prepare commands (e.g. a configuration file).
PHP build hardware resources​
Build of your PHP application is run in a separate build container with following resource configuration:
HW resource | Minimum | Maximum |
---|---|---|
CPU cores | 6 | 20 |
RAM | 8 GB | 8 GB |
Disk | 1 GB | 100 GB |
The build container is always started with the minimum hardware resources and scales vertically up to the maximum resources.
Hardware resources of the build containers are not charged. The build costs are covered by the standard Zerops project fee.
Build time limit​
The time limit for the whole build pipeline is 1 hour. After 1 hour, Zerops will terminate the build pipeline and delete the build container.
Troubleshooting build-related problems​
Failure of a build prepare command​
If any prepare command fails, it returns an exit code other than 0 and the build is canceled. Read the build log to troubleshoot the error. If the command ends successfully, it returns the exit code 0 and Zerops triggers the following command. When all prepareCommands
commands are finished, your custom build environment is ready for the build phase.
Invalidate the build cache​
Some packages or tools can take a long time to install. Therefore, Zerops caches your custom build environment after each successful build where the prepareCommands
commands were used. When the second or following build is triggered, Zerops will use the build cache from the previous build if both following conditions are met:
- Content of the build.base and build.prepareCommands attributes didn't change from the previous build
- The build cache wasn't invalidated in the Zerops GUI.
To invalidate the Zerops build cache go to your service detail in Zerops GUI, choose Service dashboard & runtime containers from the left menu and click on the Open pipeline detail button. Then click on the Invalidate build cache icon.
// TODO screenshot
When the build cache is used, Zerops doesn't run the prepare commands and the build of your application is faster.
Failure of a build command​
If any build command fails, it returns an exit code other than 0 and the build is canceled. Read the build log to troubleshoot the error. If the error log doesn't contain any specific error message, try to run your build with the -v
verbose option.
If the command ends successfully, it returns the exit code 0 and Zerops triggers the following command. When all buildCommands
are finished, the application build is completed and ready for the deploy phase.