site

Arquivos de configuração para desenvolvimento do site institucional com Docker + Lando

O objetivo é ter um ambiente de desenvolvimento (Drupal8) para desenvolvimento do site institucional utilizando Docker + Lando. Com isso não será mais necessário ter Apache, MySql e PHP instalados no desktop de desenvolvimento.

Uso

1) Certifique-se de ter instalados o lando e o docker:

Para isso acesse a documentação:

Docker: https://docs.docker.com/engine/install/ubuntu/

Lando: https://docs.lando.dev/basics/installation.html#linux

2) Reinicie seu PC

3) Baixe o site institucional para a pasta do seu projeto

4) Baixe o arquivo (.lando.yml) deste repositório para a raiz do seu projeto

# Caso utilize mysql 8, altere no arquivo .lando.yml para:
database: mysql:8.0

5) Configure os arquivos:

# Credenciais de conexão mysql iguais as do arquivo .lando.yml, onde o valor da variável host será database
# Acerte o path do projeto, lembrando que o Lando e o Docker enchergam a pasta /app como sendo a raiz do projeto
# Comente as linhas de trusted_host_patterns
# Descomente se necessário as linhas de erros php
# Deixe o valor da variável ...'name' com 'LOCAL | DEV | ECA | Escola de Comunicações e Artes'
# ou algo de sua escolha que diferencie do site em produção ou homologação
/seuprojeto/docroot/sites/default/settings.php
# Deixe a variável debug com valor true
/seuprojeto/docroot/sites/default/services.yml

6) Se existe destrói, recomplila o projeto, instala os pacotes, instala os pacotes Drush e Drupal Console

lando destroy -y 
lando rebuild -y 
lando composer install
lando composer require drush/drush:10.x drupal/drush drupal/console
lando ssh --service appserver --user root --command "chmod +x /app/vendor/drush/drush/drush"
lando ssh --service appserver --user root --command "chmod +x /app/vendor/drupal/console/bin/drupal"
lando ssh --service appserver --user root --command "rm /app/bin/drush.php"
lando ssh --service appserver --user root --command "ln -s /app/vendor/drush/drush/drush.php /app/bin/drush.php"
lando rebuild -y
lando composer install

7) Restaure o dump MySql do site

# Veririque o nome do arquivo com o dump 
lando db-import backup/site.sql

8) Desinstale os módulos Senha única USP, Google Analytics e Smtp

# No ambiente de desenvolvimento não usamos os módulos Senha Única USP, Google Analytics e SMTP (envio de e-mails)
lando drupal mou senhaunicausp google_analytics smtp

9) Instale os módulos dev

# Ativando módulos de desenvolvimento
lando drupal moi devel kint

10) Cache rebuild com Drush

# Limpe o cache com cache rebuild com Drush ou Drupal Console
lando drush cr
lando drupal cr

11) Acesse

https://ecadev.lndo.site

12) Logue com seu usuário Drupal

https://ecadev.lndo.site/user

Neste ponto o site está totalmente configurado para o ambiente dev

13) Compilando o tema eca

Baixe o arquivo npm-shrinkwrap.json e salve ele na pasta docroot/themes/custom/eca

Aumente o número de watchers executando os comandos abaixo no seu PC

sudo cat /proc/sys/fs/inotify/max_user_watches
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
sudo cat /proc/sys/fs/inotify/max_user_watches

cd docroot/themes/custom/eca
lando npm uninstall -g gulp-cli gulp --force
rm -rf node_modules
lando npm install -g gulp-cli [email protected] --force
# lando npm install -g gulp-cli gulp --save-dev --force
lando npm install --force
lando gulp watch

Neste ponto o comando gulp watch vai aguardar as mudanças feitas no tema e recompilar as modificações

Um exemplo de modificação é: Trocar o fundo do menu principal No arquivo

docroot/themes/custom/eca/assets/scss/_layout/_header/_header-base.scss

Na classe .header-main-header-menu-and-links Na linha 17 está a configuração padrão Na linha 18 está a configuração com cor cyan. Descomente essa linha.

background-color: cyan;

Salve o arquivo Note que no terminal onde o comando gulp watch foi executado, é informado que o arquivo estilos.css foi modificado, ou seja o tema foi compilado:

[Browsersync] Serving files from: ./
[12:24:13] Starting 'sass'...
[Browsersync] 1 file changed (estilos.css)
[12:24:13] Finished 'sass' after 137 ms

Agora execute o comando de cache rebuild na raiz do projeto:

lando drupal cr

Ao recarregar o siste verá que o fundo do menu principal foi alterado para a cor cyan

ATENÇÃO! Esta alteração de cor no menu e outros testes devem ser desfeitos antes de colocar as modificações necessárias em produção.

14) Comandos Lando. Tem mais comandos comentados no arquivo .lando.yml

Recompila o projeto

lando rebuild -y

Composer install no projeto

lando composer install

Só para testar o override de configurações php no arquivo php.ini

lando php -i | grep upload_max_filesize

Para iniciar o projeto

lando start

Informações do projeto

lando info

Se tem mais projetos iniciando com o mesmo exemplo de .lando.yml, certifique-se de os outros porjetos estão parados. Para isso vá na pasta do projeto que não vai utilizar no momento e execute

lando stop

Sobre o Lando

O Lando também possui outros comandos de acordo com o recipiente utilizado, Ex. Drupal8, https://docs.lando.dev/config/lamp.html#tooling

O Lando possui recipientes para outros Frameworks (Symfony) e CMS's (Drupal e Wordpress), https://docs.lando.dev/config/recipes.html#supported-recipes