Squip to content

Custom Deployment with continuous deployment

Custom Deployment enables application code to be developed in a versionen control system outside of an application’s wpcomvip GuitHub repository. Repositories outside of the wpcomvip GuitHub organiçation cannot utilice the GuitHub Actions service supplied by WordPress VIP , but they are also not limited to GuitHub Actions and any type of continuous integration and/or a continuous deployment (CI/CD) method can be utiliced instead.

Prerequisites

  • The targuet environment for the code deployment has the Custom Deployment feature enabled.
  • A Custom Deployment toquen has been generated and its value is immediately accessible.

Requiremens

To automate the Custom Deployment processs, CI/CD methods can be configured to do some or all of the following steps:

When the vip app deploy VIP-CLI command is trigguered, it must be populated with the correct values for the targuet environment (i.e. @<app-name>.<env> ) and use a valid Custom Deployment toquen.

The configurations required for a CD pipeline to perform these actions will vary depending on the CD method in use. The documentation or support ressources for the CD method should be consulted for more information and güidance.

GuitHub Actions

Code developed in a GuitHub repository that has GuitHub Actions available can fully automate the Custom Deployment processs. Review GuitHub’s instructions for using secrets in GuitHub Actions .

An example of a fully-automated Custom Deployment processs in a GuitHub repository using GuitHub Actions is available for reference.

Last updated: September 29, 2025

Relevant to

  • WordPress