Skip to content
Snippets Groups Projects
Commit 76c81056 authored by Sean Madsen's avatar Sean Madsen
Browse files

Buildkit - relocate post-install steps

This is a direct copy-paste from one section of the guide to another,
without any edits. When someone is installing buildkit, these steps are
easy to miss if they're located in the civibuild file.
parent 59eb5c96
No related branches found
No related tags found
No related merge requests found
......@@ -96,7 +96,9 @@ This will create a test environment with the Drupal, CiviCRM master branch
and the patch in PR 8494. More detailed information is in the
[Civibuild documentation](https://github.com/civicrm/civicrm-buildkit/blob/master/doc/civibuild.md)
## Configuring buildkit after installation {:#configuring}
## Post-install configuration {:#configuring}
### Configuring your path {:#path}
!!! note "Not needed for Vagrant/Docker installations"
If you set up buildkit using Vagrant or Docker, then you don't need to perform the configuration steps listed here.
......@@ -135,6 +137,41 @@ If you want to ensure that the buildkit CLI tools are always available, then:
Each time you open a new terminal while working on Civi development, you would need to re-run the `export` command.
### Configuring `amp` {:#amp-config}
!!! tip
Login as a non-`root` user who has `sudo` permission. This will ensure that new files are owned by a regular user, and (if necessary) it enables `civibuild` to restart Apache or edit `/etc/hosts`.
The first build requires only a few commands. However, these are also the
hardest commands -- you need to provide detailed information about the
Apache/MySQL/PHP systems, and you may need to try them a few times.
Configure `amp` with details of your Apache/MySQL environment. Pay close
attention to the instructions. They may involve adding a line to your
Apache configuration file.
```
$ amp config
```
Test that `amp` has full and correct information about Apache/MySQL.
```
$ amp test
```
!!! note
You may need to alternately restart httpd, re-run `amp config`, and/or re-run `amp test` a few times.
Create a new build using Drupal and the CiviCRM `master` branch.
The command will print out URLs and credentials for accessing the website.
```
$ civibuild create dmaster --url http://dmaster.localhost --admin-pass s3cr3t
```
Once you have a working build of `dmaster`, you can continue working with `civibuild` to create different builds as described below.
## Upgrading buildkit {:#upgrading}
......
......@@ -21,41 +21,6 @@ these. Unfortunately, such tools generally require extra work for a Civi
developer environment. Civibuild works with these tools and and fills
in missing parts.
## Your First Build {:#start}
!!! tip
Login as a non-`root` user who has `sudo` permission. This will ensure that new files are owned by a regular user, and (if necessary) it enables `civibuild` to restart Apache or edit `/etc/hosts`.
The first build requires only a few commands. However, these are also the
hardest commands -- you need to provide detailed information about the
Apache/MySQL/PHP systems, and you may need to try them a few times.
Configure `amp` with details of your Apache/MySQL environment. Pay close
attention to the instructions. They may involve adding a line to your
Apache configuration file.
```
$ amp config
```
Test that `amp` has full and correct information about Apache/MySQL.
```
$ amp test
```
!!! note
You may need to alternately restart httpd, re-run `amp config`, and/or re-run `amp test` a few times.
Create a new build using Drupal and the CiviCRM `master` branch.
The command will print out URLs and credentials for accessing the website.
```
$ civibuild create dmaster --url http://dmaster.localhost --admin-pass s3cr3t
```
Once you have a working build of `dmaster`, you can continue working with `civibuild` to create different builds as described below.
## Build Types
`civibuild` includes a small library of build scripts for different
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment