Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/webship/vdo
Helps Drupal developers manage base code development work cycle for custom distributions/profiles.
https://github.com/webship/vdo
distribution drupal
Last synced: 3 months ago
JSON representation
Helps Drupal developers manage base code development work cycle for custom distributions/profiles.
- Host: GitHub
- URL: https://github.com/webship/vdo
- Owner: webship
- Created: 2017-07-07T22:18:24.000Z (over 7 years ago)
- Default Branch: 10.0.x
- Last Pushed: 2024-05-27T21:18:33.000Z (9 months ago)
- Last Synced: 2024-07-02T13:11:46.995Z (7 months ago)
- Topics: distribution, drupal
- Language: PHP
- Homepage: https://www.drupal.org/project/vdo
- Size: 2.64 MB
- Stars: 3
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# VDO
The Visual Distribution Operator (VDO) management system helps developers manage the base code development work cycle for custom distributions and starter kit templates. Constructing your Linux development computer or servers.
[](https://www.drupal.org/project/vdo)
### Please backup your /var/www/html and your mysql databases;
### Try VDO with new systems only.
### Constructing your Linux development computer or servers with:
### Products:
Where custom distributions/profiles base code are maintained.
```
/var/www/html/products
```
### DEV:
Where development, enhancements, and optimization work rounds on the distribution/profile.
```
/var/www/html/dev
```
### TEST:
Where testing and functional automated testing on the distribution/profile.
```
/var/www/html/test
```
### Demos:
Where all demos templates, and default content work on the distribution/profile.
```
/var/www/html/demos
```
### Sandboxes:
Where all sandbox templates, and private custom content work on the distribution/profile.
```
/var/www/html/sandboxes
```
### Projects:
Where development on a project based on the distribution/profile product.
```
/var/www/html/projects
```
### Profiles:
Where other contrib or private installation profiles are kept.
```
/var/www/html/profiles
```
### Themes:
Where other contrib or private themes are kept.
```
/var/www/html/themes
```
### Modules:
Where other contrib or private modules are kept.
```
/var/www/html/modules
```
### VDO Configs and Scripts:
Where the general VDO configs and script libraries are kept.
```
/var/www/html/vdo/web
```
### VDO Website:
Where the general VDO config and script libraries are kept.
Which a domain could points at it, like vdo.local or vdo.devhub.company-name.com
```
/var/www/html/vdo/web
```
After Installing Ubuntu 21.04 for example you could run the following bash command to setup LAMP on Ubuntu 21.04
If you get the VDO bash files from
```
git clone 10.0.x [email protected]:webship/vdo-project.git /var/www/html
cd /var/ww/html/
sudo rm -rf .git
```
Then you could edit the VDO config file to work for your system:
```
vim /var/www/html/vdo/config/vdo.settings.yml
```
you will see something like:
```
vdo:
root: /var/www/html
path: /var/www/html/vdo
scripts: /var/www/html/vdo/scripts
config: /var/www/html/vdo/config
host: localhost
web: http://localhost/vdo
backups: /var/www/html/backups
database:
username: DATABASE_USERNAME
password: DATABASE_PASSWORD
host: DATABASE_HOST
port: 3306
namespace: Drupal\\Core\\Database\\Driver\\mysql
driver: mysql
collation: utf8mb4_general_ci
account:
name: DRUPAL_WEBMASTER_NAME
pass: DRUPAL_WEBMASTER_PASSWORD
mail: DRUPAL_WEBMASTER_EMIL
config_sync_directory: ../config/sync
workspaces:
- products
- dev
- test
- demos
- sandboxes
- profiles
- modules
- themes
- libraries
- forked
```
After you have made your changes you could install the global variables.
```
cd /var/www/html/vdo/scripts/install
bash install.sh
```
Close all terminal windows
And open a new one
Test that we are ready by
```
echo ${vdo_config}
/var/www/html/vdo/config
```
If "/var/www/html/vdo/config" was printed,which mean we are ready for the next step.
Only for Ubuntu 22.04 you could run the following command to setup your LAMP. ( You man install LAMP in your own. or copy the bash file change it to work for your system.)
```
cd /var/www/html/vdo/scripts/install/
bash setup-LAMP-ubuntu21-04--php7-04--MySQL8.sh
```
After that, you can do a composer install
```
cd /var/www/html/
composer install
```
Or you could build by composer create project command
Create a VDO Project 10.0.x with Composer
To install the most recent stable release of VDO 10.0.x run this command:
```
composer create-project webship/vdo-project /var/www/html --no-dev --no-interaction
```
To install the dev version of VDO 10.0.x run this command:
```
composer create-project webship/vdo-project:10.0.x-dev /var/www/html --stability dev --no-interaction
```
Status message
After that delete the composer.josn and composer.lock file from your /var/www/html folder
```
cd /var/www/html/
rm composer.json composer.lock
```
To test that the VDO settings are working
If you go to DEV you can find many bash files that could help you in your development of the profile.
```
cd /var/www/html/dev/
bash cmd-vdo-drupal10-recommended-project.sh drupal10c1 --install
```
### Varbase disto for example:
```
cd /var/www/html/dev/
bash cmd-vdo-varbase10-project.sh varbase10c1 --install --add-users
```
### Create custom VDO bash:
Having a new dev or test bash files to add more work or commands in them. Add the heading in a new file then use any of the ready variables by the VDO bootstrap settings or the workspace settings or values.
### Example:
```
cd /var/www/html/dev/
vim cmd-vdo-example.sh
```
Then in the file, you could add the following:
```
#!/bin/usr/env bash
# Bootstrap VDO.
. ${vdo_scripts}/bootstrap.sh ;
# Load workspace settings and extra lists.
eval $(parse_yaml ${vdo_config}/workspace.dev.settings.yml);
echo "*---------------------------------------------------------------------------------------*";
echo "| Build Drupal Project and add 100 modules in one command";
echo "*---------------------------------------------------------------------------------------*";
```
Have your own YML files. Read them in bash files as arrays of variables.And use them in custom bash file in the way you like:
```
eval $(parse_yaml ${path_to_the_yml_file}/name-of-file.yml);
```
Have a look at the number of bash files like the themes, profiles. or test in
https://github.com/webship/vdo-project
Learn by example. For sure have your naming or coding style or any language in the bash files, like python, C, PHP, or normal Bash.