This project is a Drupal 9 SEC's internal site Catalog.

• Catalog - https://catalog.sec.gov

1. Request access to GitLab and Acquia Cloud.
2. Ensure that your computer meets the minimum installation requirements for Lando v3.0.26 and Docker 2.5.0.1.
3. Install Docker 2.5.0.1
4. Install Lando v3.0.26
5. Setup a SSH key that can be used for GitLab and the Acquia Cloud (Use same SSH key for both accounts).
   1. Setup GitLab SSH Keys
   2. Setup Acquia Cloud SSH Keys
6. Install necessary tools listed below:
   1. Command line tools:
      1. GitBash - Required
      2. cmder for better command-line support - Optional
      3. Windows Terminal - Optional
   2. Code Editors:
      1. VSCode - Required
      2. Notepad++ - Required
      3. PhpStorm - Optional

1. Start a command line tool to configure Git.
2. Set username and email (Change email and name value to your work email and name).

   $ git config --global user.name "Your Name"
   $ git config --global user.email "[email protected]"
   

3. Set default Linux (LF) line ending instead of Windows (CRLF).

   $ git config --global core.autolf true
   $ git config --global core.autocrlf false
   

4. Allow Git to have longpath.

   $ git config --global core.longpaths true
   

1. Clone repository using a command line tool. By default, Git names this "origin" on your local.

   $ git clone [email protected]:sec/datacatalog.git ~/sites/catalog/
   

2. Change directory to catalog project

   $ cd ~/sites/catalog/
   

3. Start local LAMP stack with Lando (Docker will start automatically if not, run Docker manually)

   $ lando start
   

4. Login to Acquia CLI (acli) Note: Only required if you are building lando project from scratch or after $ lando destroy.

   $ lando acli auth:login
   

   Follow the prompts to complete setting up Acquia CLI.

   • Would you like to share anonymous performance usage and data? (yes/no) - [No]
   • Do you want to open this page to generate a token now? (yes/no) - [No]
   • Please enter your API Key: - [Generate this from Acquia: https://cloud.acquia.com/a/profile/tokens]
   • Please enter your API Secret (input will be hidden): - [Generate this from Acquia: https://cloud.acquia.com/a/profile/tokens]

5. Pull database locally.

   $ lando pulldb
   

6. Run database import command to import database locally.

   Site	Command
   Catalog	$ lando db-import catalogdb.sql -h catalogdb

7. Initialize a project.

   Site	Command
   Catalog	$ lando initproject-catalog

1. Install VNC Viewer
2. Open VNC Viewer and connect to localhost:5902
3. Start a command line tool and change directory to catalog project.

   $ cd ~/sites/catalog/
   

4. Initialize Behat.

   $ lando initbehat
   

5. Run Behat command.

   Site	Command
   Catalog	$ lando behat-catalog

Below is a list of useful command for local lando setup. Use $ lando --help command to display additional commands.