The local development stack allows college developers to update the theme for their College’s website. This capability should mainly be used to modify CSS for branding imagery and custom page-specific styles.
Instructions
Getting Access to
...
Your College Pantheon Site
Before using the local development stack for the first time, you will need to complete the following steps:
To get access to the District VPN and Common Framework Bitbucket repoPantheon Dashboard, send a request with your MEID and Bitbucket user name to the ITS Web Team via Slack or ITS.Drupal.Team@domail.maricopa.edu
For Windows: follow the VPN Setup Instructions. You will need to download the VPN Client and Remote Desktop Connection if not already installed. You must be logged into Accounts.Maricopa.edu to download these files.
For Mac: use the built in VPN interface in Network preferences or download the AnyConnect Client (you'll need to sign in twice… seriously).
| Note |
|---|
Must use DO VPN to connect to Dev CDN FTP. College VPNs don't work. |
Running the Local Development Environment
...
Connect to the District VPN.
...
| Info |
|---|
Mac users may use Pantheon Localdev for local development as an alternative to the following Lando instructions. |
Instructions for Using Lando
| Info |
|---|
Hardware requirements: https://docs.lando.dev/basics/installation.html#hardware-requirements |
Generate and add an SSH key to your Pantheon account.
Install Lando and the Docker version that comes with it. Lando v3.011.0-aft.2 has been tested on Windows, Mac, and WindowsLinux. Other versions will not be supported.Follow the instructions in the README.md to run the local development environment.
Install Git.
Get the Code
Sign into the Pantheon Dashboard.
Select the “Organizations” tab below your username and follow the “Maricopa Community College” link.
Locate your Site Name and click the name to open the site dashboard.
Find the “Clone with Git” button and use the code to clone your site’s code in a terminal.
Running Lando
Start Lando.
| Code Block |
|---|
lando start |
Once up and running, Lando will return the site URL. Look under "APPSERVER URLS" for the address to use in your browser. It will be similar to: http://[app].lndo.site.
Download and import the site's database and content files.
| Code Block |
|---|
lando pull --code=none --database=dev --files=dev |
Logging into Drupal
Google Auth will not be available in your development environment. Use the following drush command to login with your MEID:
| Code Block |
|---|
lando drush uli meid123456 |
Rebuilding the Dev Environment
When Lando stops working you may need to rebuild the service containers. Do the following procedure to wipe your Lando instance and build a fresh install. Warning: This procedure will delete your database contents and all Lando/Docker images.
| Code Block |
|---|
lando poweroff
lando destroy
docker system prune
lando start
lando pull |
Troubleshooting
Cannot Create Directory
If you encounter this Windows error after downloading and importing the site's database and content files:
...
Resolving this will require manually creating the symbolic link.
In Git Bash, run the following commands:
| Code Block |
|---|
rm web |
| Code Block |
|---|
ln -s docroot web |
Proceed again with downloading and importing the site's database and content files:
| Code Block |
|---|
lando pull --code=none --database=dev --files=dev |
| Note |
|---|
If you have to use this fix, make sure your code edits are reflected in the |