Download the PHP package mmoollllee/bedrock-deployer-7 without Composer
On this page you can find all versions of the php package mmoollllee/bedrock-deployer-7. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mmoollllee/bedrock-deployer-7
More information about mmoollllee/bedrock-deployer-7
Files in mmoollllee/bedrock-deployer-7
Package bedrock-deployer-7
Short Description Deployer recipes for Roots Bedrock
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package bedrock-deployer-7
bedrock-deployer-7
Deployer 7 recipes for Roots Bedrock, also supports Roots Sage and Roots Trellis setups. Based on the work by FlorianMoser
Trellis provides a powerful deployment with Ansible. But if you would like to deploy Bedrock only while running a custom process, Deployer is a quick and simple alternative.
Maybe you are even trying to deploy Bedrock to a shared hosting like Plesk. Depending on your hosting environment, this can be possible.
A word of caution: Make sure you have a backup of your local as well as your remote files, before experimenting with deployment recipes. Files might easily get overwritten when you provide wrong paths! You are solely responsible by using the recipes provided here.
Who needs this
PHP developers who would like to deploy their Bedrock applications using Deployer v7.
Installation
Use Composer:
`
Setup your Trellis & Bedrock environment and create a repository. The repository may contain a trellis and a site folder, or the bedrock project example
Create a deploy.php in your project root and configure your environments. You might want to use examples/deploy.full-example.php and have a look at its required config file. If so, first run will create a .env.deployer and ask for your project's details.
First run with vendor/bin/dep -vvv deploy & select target environment.
Recipes
This package offers several recipes to help you with your Bedrock deployment. Require each package as needed or use the example configuration file in examples/deploy.full-example.php and have a look at its required config file.
The available recipes:
Bedrock DB
Provides tasks to export the database from the server and import it to your development machine and vice versa.
Trellis / VM / Vagrant environment
Requirements:
- Virtual Machine (Vagrant, Lima,...) running on your local machine (or Trellis, of course)
- WP CLI running on your Virtual Machine as well as on your remote machine
Load into your deploy.php file with:
``
Requires these Deployer environment variables to be set:
- local_root: Absolute path to website root directory on local host machine
- trellis_dir: Absolute path to directory that contains trellis
- vm_root: Absolute path to website inside Virtual machine (should mirror local_root)
- vm_shell: Virtual Machine SSH Pattern (e.g.
vagrant ssh -- -t cd {{vm_root}})
Example:
``
Valet+ environment
Requirements:
- Bedrock running on Valet+
Load into your deploy.php file with:
``
Requires these Deployer environment variables to be set:
- local_root: Absolute path to website root directory on local host machine
Example:
``
Task pull:db
Exports database on server and imports it into your local Vagrant database, while removing previous data. Creates a backup of the local database in the local_root directory, before importing the new data.
After the import, the WordPress URLs are converted from server URL to local URL, so your WordPress installation will continue to work right after the import.
Database credentials and URLs are read from remote and local .env file. So make sure, those files are up to date.
Task push:db
Exports database from local Vagrant database and imports it into your remote server, while removing previous data. Creates a backup of the remote database on the server in the current release directory, before importing the new data.
After the import, the WordPress URLs are converted from local URL to remote URL, so your WordPress installation will continue to work right after the import.
Database credentials and URLs are read from remote and local .env file. So make sure, those files are up to date.
Bedrock .env
Provides tasks to manage the .env file on the server.
Load into your deploy.php file with:
``
Requires no special Deployer environment variables to be set.
Task bedrock:env
Tries to copy the .env file from a previous release to current release. If there is no previous release or if no .env file is available, the .env file is created while prompting the user for credentials.
When creating a new .env file, this task also generates the WordPress salts.
Bedrock Miscellaneous
Provides miscellaneous Bedrock tasks.
Load into your deploy.php file with:
``
Requires no special Deployer environment variables to be set.
Task bedrock:vendors
Runs composer install for Bedrock on your server.
Common
Provides common deployment tasks.
Requirements:
- WP CLI running on your Vagrant as well as on your remote machine
Load into your deploy.php file with:
``
Requires no special Deployer environment variables to be set.
Task activate:plugins
Activates all plugins on remote server.
Filetransfer
Provides tasks to upload/download files from/to synced directories.
Load into your deploy.php file with:
``
Requires these Deployer environment variables to be set:
- sync_dirs: Array of paths, that will be simultaneously updated with $absoluteLocalPath => $absoluteRemotePath. If a path has a trailing slash, only its content will be transferred, not the directory itself.
Example:
``
Task pull:files
Will pull all files from each $absoluteRemotePath to each $absoluteLocalPath. New files will be added, existing files will be updated, but files existing locally only will not be deleted.
To ensure no files are lost, each $absoluteLocalPath and its content are backed up in a zip file that will be added in the $absoluteLocalPath. Existing backups from previous pulls are not included in a new backup.
If you prefer to pull the files without making a backup, consider using the task pull:files-no-bak.
Task push:files
Will push all files from each $absoluteLocalPath to each $absoluteRemotePath. New files will be added, existing files will be updated, but files existing on remote server only will not be deleted.
To ensure no files are lost, each $absoluteRemotePath and its content are backed up in a zip file that will be added in the $absoluteRemotePath. Existing backups from previous pushes are not included in a new backup.
If you prefer to push the files without making a backup, consider using the task push:files-no-bak.
Sage
Provides tasks to deploy Roots Sage theme.
Requirements:
- Roots Sage 10 (also supports Sage 9, see the included /examples/deploy.full-example.php on how to use with Sage 9)
Load into your deploy.php file with:
``
Requires these Deployer environment variables to be set:
- theme_path: Path to theme, relative to release_path
- local_root: Absolute path to website root directory on local host machine
Example:
``
Task sage:vendors
Runs composer install inside Sage theme directory.
Task sage:assets
Compiles the Sage assets on the local machine and then uploads them to remote server in theme directory (overwriting previous assets!).
Trellis
You will not want to use these recipes to deploy Trellis. Trellis has its own and powerful deployment process. However you might use Trellis for developing and only use these recipes to deploy Bedrock.
You might have a site & a trellis directory in your repository, or only the bedrock-style repository without site folder. This task deals with both situations:
Task trellis:remove
Will check for a /site folder. If true it will delete the remote /trellis directory and move the content of /site to /. Use this task after deployment but before symlink changes.
Advanced Custom Fields Pro
ACF PRO is a powerful Wordpress Plugin to build userfriendly custom fields and more. The Pro version via composer install needs a auth.json for authentification. See official documentation on how to get it's content.
Task bedrock:acf
Uploads your local auth.json to the release directory.
