Git Product home page Git Product logo

docs's Introduction

Lando Docs

This repo contains the documentation site for Lando. That said Lando is comprised of various constituent projects that are all combined together. So while this is the main site you should think about it more as the "glue" that combines various subsites together into a cohesive docs expereince. Said more plainly. if you are looking to update the docs on say the Lagoon recipe then you should do so in the Lagoon repo.

Here is a non-exhaustive list of some of the other docs subsites:

However, it's best to just search for the repo you are looking for in the main Lando org and consult its README on how to update its docs.

Issues, Questions and Support

If you have a question or would like some community support we recommend you join us on Slack. Note that this is the Slack community for Lando but we are more than happy to help with this module as well!

If you'd like to report a bug or submit a feature request then please use the issue queue in this repo.

Changelog

We try to log all changes big and small in both THE CHANGELOG and the release notes.

Development

# Clone repo
git clone https://github.com/lando/docs.git && cd docs

# Install deps
npm install

# Launch dev site
npm run dev

# Lint
npm run lint

# Build site
npm run build

Releasing

To deploy and publish a new version of the package to the npm registry you need only create a release on GitHub with a semver tag.

Note that prereleases will get pushed to the edge tag on the npm registry.

Maintainers

Contributors

Made with contributors-img.

Other Resources

docs's People

Contributors

aaronfeledy avatar akalipetis avatar alisonjo315 avatar benjamintoussaint avatar bobbyschnipke avatar dependabot[bot] avatar github-actions[bot] avatar gitressa avatar laryn avatar millnut avatar mugotech avatar pirog avatar ptmkenny avatar purdy avatar rabauss avatar reynoldsalec avatar simjost avatar tyrann0us avatar uberhacker avatar xurizaemon avatar yaronuliel avatar zuernbernhard avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

docs's Issues

Document info regarding passwordless SSH keys needed for manually cloned repos

Repositories that were cloned manually will most likely not use a lando init command, and thus will not receive an auto-generated passwordless SSH key.

Since a user's SSH key might have a password on it, and Lando will not import such keys into the app for use with lando pull, etc, we need to document this in enough places that new users who find themselves in this situation won't think that something's broken.

Document proxy settings

While docker provides some docs around what to do when you are behind a proxy. It is probably for us to surface our own docs in the "known issues" section. Specifically, we need to:

  1. detail the two approaches to inject envvars (.env file vs overrides) and link to docs
  2. Link to relevant docker docs
rohith [5:44 AM] 
@pirog It worked. Thanks. I added by proxy
```http_proxy=http://my_proxy:80```
to the .env file

Some doc tweakz

Let's

  • Make it more clear that Tandem is responsible for this awesome sauce
  • That there are additional languages that can be used
  • That there are additional services that can be used

Specifically we should give some credit to Tandem for the project in the README.md + docs/README.me with linkage to the Tandem site and Add two additional link sections in README.md + docs/README.me so it looks more like

Begin by checking out the

Then spin up one of our preconfigured recipe start states

or build up from a base language

  • php
  • ruby
  • node
    ...
  • pythong

and then mix in auxiliary services

  • mariab
  • solr
    ...
  • varnish

and then try out some advanced stuff

and then dive deep into reference materials

Drush not bootstrapped while running commands from the host

.lando.yml

name: drushtest
recipe: drupal8
config:
  webroot: web
  xdebug: true

Directory contents

$ ls -la
total 720
drwxr-xr-x@  21 rob  staff     672 Oct 23 09:17 .
drwxr-xr-x@  10 rob  staff     320 Oct 21 20:30 ..
drwxr-xr-x@  16 rob  staff     512 Oct 23 09:28 .git
-rw-r--r--@   1 rob  staff    2012 Oct 18 12:14 .gitignore
-rw-r--r--@   1 rob  staff    2162 Oct  5 13:55 .gitlab-ci.yml
drwxr-xr-x@   9 rob  staff     288 Oct 19 12:35 .idea
-rw-r--r--@   1 rob  staff      70 Oct 23 09:27 .lando.yml
-rw-r--r--@   1 rob  staff    1074 Oct  5 13:55 LICENSE
-rw-r--r--@   1 rob  staff     483 Oct  5 13:55 README.md
-rw-r--r--@   1 rob  staff    3948 Oct 18 12:09 circle.yml
-rw-r--r--@   1 rob  staff    4473 Oct 21 20:32 composer.json
-rw-r--r--@   1 rob  staff  328949 Oct 21 20:32 composer.lock
drwxr-xr-x@ 681 rob  staff   21792 Oct 21 20:32 config
drwxr-xr-x@   3 rob  staff      96 Oct  5 13:55 console
drwxr-xr-x@   4 rob  staff     128 Oct  5 14:25 drush
-rw-r--r--@   1 rob  staff     600 Oct  5 13:55 pantheon.yml
drwxr-xr-x@   4 rob  staff     128 Oct  5 13:55 patches
drwxr-xr-x@   5 rob  staff     160 Oct  5 13:55 scripts
drwxr-xr-x@   5 rob  staff     160 Oct  5 13:55 tests
drwxr-xr-x@  48 rob  staff    1536 Oct 20 14:05 vendor
drwxr-xr-x@  18 rob  staff     576 Oct 20 14:00 web

App startup

$ lando start
landoproxyhyperion5000gandalfedition_proxy_1 is up-to-date
Creating network "drushtest_default" with the default driver
Creating volume "drushtest_appserver" with default driver
Creating volume "drushtest_data" with default driver
Creating volume "drushtest_data_database" with default driver
Creating drushtest_database_1 ...
Creating drushtest_appserver_1 ...
Creating drushtest_database_1
Creating drushtest_appserver_1 ... done
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 5988k  100 5988k    0     0  3992k      0  0:00:01  0:00:01 --:--:-- 3992k
 PHP configuration      :  /usr/local/etc/php/php.ini
 PHP OS                 :  Linux
 Drush script           :  /tmp/drush.phar
 Drush version          :  8.1.13
 Drush temp directory   :  /tmp
 Drush configuration    :
 Drush alias files      :

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  652k  100  652k    0     0   251k      0  0:00:02  0:00:02 --:--:--  252k

BOOMSHAKALAKA!!!

Your app has started up correctly.
Here are some vitals:

 NAME            drushtest
 LOCATION        /Users/rob/work/c3/c3.com/new/www
 SERVICES        appserver, database

 APPSERVER URLS  https://localhost:32793
                 http://localhost:32794
                 http://drushtest.lndo.site
                 https://drushtest.lndo.site

$ lando info

{
  "appserver": {
    "type": "php",
    "version": "7.1",
    "via": "apache",
    "webroot": "web",
    "config": {
      "conf": "/Users/rob/.lando/services/config/drupal8/php.ini"
    },
    "urls": [
      "https://localhost:32793",
      "http://localhost:32794",
      "http://drushtest.lndo.site",
      "https://drushtest.lndo.site"
    ]
  },
  "database": {
    "type": "mysql",
    "version": "latest",
    "creds": {
      "user": "drupal8",
      "password": "drupal8",
      "database": "drupal8"
    },
    "internal_connection": {
      "host": "database",
      "port": 3306
    },
    "external_connection": {
      "host": "localhost",
      "port": "32790"
    },
    "config": {
      "confd": "/Users/rob/.lando/services/config/drupal8/mysql"
    }
  }
}

Drush

$ lando drush st
 PHP executable         :  /usr/local/bin/php
 PHP configuration      :  /usr/local/etc/php/php.ini
 PHP OS                 :  Linux
 Drush script           :  /app/vendor/drush/drush/drush.php
 Drush version          :  8.1.15
 Drush temp directory   :  /tmp
 Drush configuration    :
 Drush alias files      :
$ lando drush pml
Command pm-list needs a higher bootstrap level to run - you will need to invoke drush from a more functional Drupal environment to run this command.   
The drush command 'pml' could not be executed.

Tooling documentation - indentation issue

There's an indentation issue in docs/tutorials/frontend.md under 'Adding Grunt/Gulp/Etc.':

services:
  node:
    type: node:6.10
    build:
      - "cd $LANDO_MOUNT && npm install"
      - "cd $LANDO_MOUNT && gulp"
globals:
  gulp-cli: "latest"

'globals' should be under 'node', I think:

services:
  node:
    type: node:6.10
    build:
      - "cd $LANDO_MOUNT && npm install"
      - "cd $LANDO_MOUNT && gulp"
    globals:
      gulp-cli: "latest"

Developing offline not working.

Bug Report

Setup

Lando version and operating system

v3.0.0-beta.22 on macOS High Sierra 10.13

Local .lando.yml

# Drupal 8 recipe
name: taher

# Start with the default Drupal 8 recipe
recipe: drupal8

# Configure the Drupal8 recipe
config:
  php: '7.1'
  via: nginx
  webroot: web
  drush: stable
  drupal: true
  database: mariadb:10.2
  xdebug: true

What am I trying to do?

Following the instructions for macOS verbatim from Documentation

Error

  1. I have appended the following ๐Ÿ‘‡ to my /usr/local/etc/dnsmasq.conf

address=/local/127.0.0.1

  1. Restarted dnsmasq successfully using ๐Ÿ‘‡

sudo brew services restart dnsmasq

  1. I have the following ๐Ÿ‘‡ in my ~/.lando/config.yml file
proxyDomain: local
  1. When I run the lando start as per step 8 from Documentation I get the following

error

Offline development using the domain name is not working locally for me.

More Debugging Info

  1. The output of lando info in my apps directory (ran in a new terminal while the lando start command was stuck).
{
  "appserver": {
    "type": "php",
    "version": "7.1",
    "via": "nginx",
    "webroot": "web",
    "config": {
      "server": "/Users/taher/.lando/services/config/drupal8/drupal8.conf",
      "conf": "/Users/taher/.lando/services/config/drupal8/php.ini"
    }
  },
  "nginx": {
    "urls": [
      "https://localhost:32895",
      "http://localhost:32896",
      "http://taher.local",
      "https://taher.local"
    ]
  },
  "database": {
    "type": "mariadb",
    "version": "10.2",
    "creds": {
      "user": "drupal8",
      "password": "drupal8",
      "database": "drupal8"
    },
    "internal_connection": {
      "host": "database",
      "port": 3306
    },
    "external_connection": {
      "host": "localhost",
      "port": "32859"
    },
    "config": {
      "confd": "/Users/taher/.lando/services/config/drupal8/mysql"
    }
  }
}
  1. Not able to visit http://taher.local , https://taher.local

In Chrome I get the following

chrome_error

Update behat-ish docs with some windows caveats

Feature/Enhancement Request

Documentation request:
I want to add behat support to lando for an app I created with the pantheon recipe.

Please provide some detail on how lando can help solve this problem

I am on Windows 10 Pro with landov3-beta13. I created a lando app with the pantheon recipe (drupal 8).
When I enter lando behat, I get Unknown argument: behat.

I read the page about Lando and Behat, which says to add BEHAT_PARAMS: '{"extensions" : {"Behat\\MinkExtension" : {"base_url" : "http://lando-pantheon-workflow.lndo.site/"}, "Drupal\\DrupalExtension" : {"drush" : { "root": "/app/web" }}}}' to lando.yml.

I did that and restarted the app as suggested but it still doesn't recognize the behat argument.

I also checked out issue #137 which has some issue on behat with the pantheon composer repo but it doesn't mention anything about using lando to run behat.

Any help about how to get this going would be much appreciated.

Write a tutorial on how to run lando in a CI envrionment

Let's write a tutorial (https://github.com/kalabox/lando/tree/master/docs/tutorials) that a user can follow so that when they are done reading they have a good idea of how to set up lando in travis or circle ci so they can super streamline their devops. presumably this would include

  1. installing kalabox on travis/circle
  2. running a lando start comand
  3. having lando handle dependency installation
  4. having lando handle task running

(a basic code linting and code standards check here is probably best)

the input device in not a TTY - Need to clarify win terminal usage in the docs

Please complete the following steps.

The more steps you complete the more likely we are to address your issue!

  1. Please review the current list of issues to make sure you are not submitting a duplicate.
  2. Please tag your issue appropriately. Please review the tagging criteria.
  3. Based on the issue type tag selected above please fill in the relevant section below.

Bug Report

v3.0.0-beta10 on Windows 10 Professional

Tell us about your .lando.yml

Paste in the contents of your .lando.yml this is SUPER HELPFUL for us.

recipe: drupal7
config:
  webroot: .

Tell us about the command you were running

lando start
lando db-import database.sql.gz

Tell us about the error you got
the input device is not a TTY. If you are using mintty, try prefixing the command with 'winpty'

When I initally created the lando site I got the same error at lando start but it worked the second time. The 'lando db-import' gives the error every time.

Please detail the steps we can take to replicate this bug. Be as detailed as possible.

1. lando init --recipe drupal7
2. lando start
3. lando db-import database.sql.gz

Tell us more

Could better documentation have prevented this issue? if so what should we change?

Does this bug prevent you from using lando?
Yes

Inform Kalabox users that Lando can be run alongside in order to ease the transition

What's the Goal?

Former or existing Kalabox users who arrive at the new Lando GitHub repo are not currently presented with the fact that Lando can be run alongside Kalabox.

Why Is It Important?

Cognitive ease is a good thing to encourage in this case, so that those users will feel more inclined to try Lando without feeling like they would have to rip out and uninstall everything they've got in Kalabox so far.

How Will We Know It's Done?

  • A one-liner factoid added to the front page of the Lando repo mentioning that the two are side-by-side compatible.

Helpful tutorials

  • Using browsersync and front end tooling
  • Using CI
  • Pulling a Pantheon site from github
  • Generic front end tooling
  • Adding additional commands
  • Building out an acquia like example
  • Using GIT
  • More pantheon
  • Using Behat with lando

Update github issue template

As a contributor to lando it would be great if people who created issues also posted in their .lando.yml (and related config) so i can more easily replicate their situation.

also would be good to add instructions to run lando logs and paste that in as well

Write a composer tutorial

Let's write a tutorial (https://github.com/kalabox/lando/tree/master/docs/tutorials) that a user can follow so that when they are done reading they have a good idea of how to set up and use composer things with lando. presumably this would include

  1. adding in a composer install build step
  2. adding tooling to composer tools like phpunit/phpcs
  3. adding composer test (scripts session in composer.json, simple linting/code standards example)

ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign

version: v3.0.0-beta.8

lando commit: fa3552d
version:

today I got this error:

Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
error:  Error: Error: 1
    at /Users/geoff/code/lando.dev/lib/promise.js:56:17
    at runCallback (timers.js:651:20)
    at tryOnImmediate (timers.js:624:5)
    at processImmediate [as _immediateCallback] (timers.js:596:5)
From previous event:
    at rec (/Users/geoff/code/lando.dev/lib/promise.js:42:13)
    at /Users/geoff/code/lando.dev/lib/promise.js:50:20
    at ontimeout (timers.js:365:14)
    at tryOnTimeout (timers.js:237:5)
    at Timer.listOnTimeout (timers.js:207:5)
From previous event:
    at /Users/geoff/code/lando.dev/lib/promise.js:49:12
    at runCallback (timers.js:651:20)
    at tryOnImmediate (timers.js:624:5)
    at processImmediate [as _immediateCallback] (timers.js:596:5)

on trying to start any new lando d8 or pantheon apps, but I suspect it wouldโ€™ve been any new app.

doing:

docker network prune

solved the issue

I donโ€™t understand a lot of the things in this issue: https://github.com/reduardo7 but maybe you guys do; donโ€™t know if there is anything we can do about it on the lando side, but most people prolly wont have 30+ lando appss
GitHub
reduardo7 (Eduardo Cuomo)
reduardo7 has 77 repositories available. Follow their code on GitHub.

Set Drupal Console on by default for D8 recipes?

Has anyone been able to run Drupal Console commands?

Per the documentation for Drupal 8, I should be able to run lando drupal; however, after running the commands below, I get Unknown argument: drupal.

git clone -b 8.4.x https://github.com/drupal/drupal.git d8
cd d8
lando init --recipe drupal8
lando start
lando composer install
lando drupal

I'm currently running Lando v3.0.0-beta.19 on macOS Sierra (10.12.6).

My auto-generated yaml file looks like this

name: d-8
recipe: drupal8
config:
  webroot: .

The output of the same command with verbose mode on:

lando drupal -- -vvvv
verbose: Loading event pre-bootstrap priority 1
info: Bootstrap starting...
debug: Boostrapping with appsRoot=/Users/mmenavas/Lando, appRegistry=/Users/mmenavas/.lando/appRegistry.json, cache=true, composeBin=/Applications/Docker.app/Contents/Resources/bin/docker-compose, composeVersion=3.2, configFilename=config.yml, appConfigFilename=.lando.yml, dockerBin=/Applications/Docker.app/Contents/Resources/bin/docker, dockerBinDir=/Applications/Docker.app/Contents/Resources/bin, engineId=1604669034, engineGid=120897380, TERM_PROGRAM=Apple_Terminal, ANDROID_HOME=/Users/mmenavas/Library/Android/sdk, TERM=xterm-256color, SHELL=/bin/bash, TMPDIR=/var/folders/by/kmwtn43j4j7bdr9f0xbkzt9sgt_ll_/T/, Apple_PubSub_Socket_Render=/private/tmp/com.apple.launchd.8E9OGTBsgA/Render, TERM_PROGRAM_VERSION=388.1.1, OLDPWD=/Users/mmenavas/lando-sites/d8/core, TERM_SESSION_ID=DD21618A-983A-4D25-B764-BB38143F73E8, USER=mmenavas, SSH_AUTH_SOCK=/private/tmp/com.apple.launchd.yJzrqOr2a4/Listeners, __CF_USER_TEXT_ENCODING=0x5FA54E6A:0x0:0x0, PATH=/Applications/Docker.app/Contents/Resources/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/mmenavas/Library/Android/sdk/tools:/Users/mmenavas/Library/Android/sdk/platform-tools:/Users/mmenavas/Library/Android/sdk/tools:/Users/mmenavas/Library/Android/sdk/platform-tools, PWD=/Users/mmenavas/lando-sites/d8, LANG=en_US.UTF-8, XPC_FLAGS=0x0, XPC_SERVICE_NAME=0, HOME=/Users/mmenavas, SHLVL=2, LOGNAME=mmenavas, LC_CTYPE=en_US.UTF-8, _=/usr/local/bin/lando, home=/Users/mmenavas, isNW=false, logLevel=debug, logLevelConsole=warn, node=v8.0.0, type=Darwin, platform=darwin, release=16.7.0, arch=x64, report=true, url=http://metrics.devwithlando.io, srcRoot=/snapshot/cli, sysConfRoot=/Applications/Lando.app/Contents/MacOS, userConfRoot=/Users/mmenavas/.lando, version=3.0.0-beta.19, plugins=[lando-core, lando-events, lando-proxy, lando-recipes, lando-services, lando-tooling], mode=cli
silly: It's not particularly silly, is it? I mean, the right leg isn't silly at all and the left leg merely does a forward aerial half turn every alternate step.
verbose: Emitting event pre-bootstrap
debug: Event pre-bootstrap has 1 listeners
verbose: Trying to load plugins 0=lando-core, 1=lando-events, 2=lando-proxy, 3=lando-recipes, 4=lando-services, 5=lando-tooling
debug: Searching for lando-core plugin in ["/snapshot/cli/node_modules/lando-core/index.js","/snapshot/cli/plugins/lando-core/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-core/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-core/index.js","/Users/mmenavas/.lando/node_modules/lando-core/index.js","/Users/mmenavas/.lando/plugins/lando-core/index.js"]
debug: Searching for lando-events plugin in ["/snapshot/cli/node_modules/lando-events/index.js","/snapshot/cli/plugins/lando-events/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-events/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-events/index.js","/Users/mmenavas/.lando/node_modules/lando-events/index.js","/Users/mmenavas/.lando/plugins/lando-events/index.js"]
debug: Searching for lando-proxy plugin in ["/snapshot/cli/node_modules/lando-proxy/index.js","/snapshot/cli/plugins/lando-proxy/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-proxy/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-proxy/index.js","/Users/mmenavas/.lando/node_modules/lando-proxy/index.js","/Users/mmenavas/.lando/plugins/lando-proxy/index.js"]
debug: Searching for lando-recipes plugin in ["/snapshot/cli/node_modules/lando-recipes/index.js","/snapshot/cli/plugins/lando-recipes/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-recipes/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-recipes/index.js","/Users/mmenavas/.lando/node_modules/lando-recipes/index.js","/Users/mmenavas/.lando/plugins/lando-recipes/index.js"]
debug: Searching for lando-services plugin in ["/snapshot/cli/node_modules/lando-services/index.js","/snapshot/cli/plugins/lando-services/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-services/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-services/index.js","/Users/mmenavas/.lando/node_modules/lando-services/index.js","/Users/mmenavas/.lando/plugins/lando-services/index.js"]
debug: Searching for lando-tooling plugin in ["/snapshot/cli/node_modules/lando-tooling/index.js","/snapshot/cli/plugins/lando-tooling/index.js","/Applications/Lando.app/Contents/MacOS/node_modules/lando-tooling/index.js","/Applications/Lando.app/Contents/MacOS/plugins/lando-tooling/index.js","/Users/mmenavas/.lando/node_modules/lando-tooling/index.js","/Users/mmenavas/.lando/plugins/lando-tooling/index.js"]
verbose: Loading event post-bootstrap priority 1
verbose: Loading event post-bootstrap priority 5
verbose: Loading event post-bootstrap priority 9
verbose: Loading event post-instantiate-app priority 1
verbose: Loading event post-instantiate-app priority 5
verbose: Loading event post-instantiate-app priority 1
verbose: Loading event post-instantiate-app priority 1
verbose: Loading event post-bootstrap priority 1
verbose: Loading event post-instantiate-app priority 1
verbose: Loading event post-bootstrap priority 5
verbose: Loading event poweroff priority 5
verbose: Loading event post-instantiate-app priority 5
verbose: Loading event post-bootstrap priority 1
verbose: Loading event post-bootstrap priority 5
verbose: Loading event post-bootstrap priority 8
verbose: Loading event post-instantiate-app priority 2
verbose: Loading event post-bootstrap priority 1
verbose: Loading event post-bootstrap priority 5
verbose: Loading event post-bootstrap priority 9
verbose: Loading event post-instantiate-app priority 3
verbose: Loading event post-bootstrap priority 1
verbose: Loading event post-bootstrap priority 5
verbose: Plugin lando-core loaded from /snapshot/cli/plugins/lando-core/index.js
verbose: Plugin lando-events loaded from /snapshot/cli/plugins/lando-events/index.js
verbose: Plugin lando-proxy loaded from /snapshot/cli/plugins/lando-proxy/index.js
verbose: Plugin lando-recipes loaded from /snapshot/cli/plugins/lando-recipes/index.js
verbose: Plugin lando-services loaded from /snapshot/cli/plugins/lando-services/index.js
verbose: Plugin lando-tooling loaded from /snapshot/cli/plugins/lando-tooling/index.js
info: Core plugins loaded
verbose: Emitting event post-bootstrap
debug: Event post-bootstrap has 13 listeners
info: Initializing init framework
info: Initializing events
info: Initializing recipes
info: Initializing services
verbose: Copying scripts config from /snapshot/cli/plugins/lando-services/scripts to /Users/mmenavas/.lando/services/config/scripts
verbose: Copying helpers config from /snapshot/cli/plugins/lando-services/helpers to /Users/mmenavas/.lando/services/config/helpers
info: Initializing tooling
verbose: Loading event task-init-answers priority 5
verbose: Loading event task-init-run priority 5
debug: Retrieved from file cache with key init:auth:github:tokens
debug: Cache miss with key init:auth:github:tokens
info: Initializing proxy
verbose: Proxy initialized with config proxy=ON, proxyDash=58086, proxyHttpPort=80, proxyHttpsPort=443, proxyHttpFallbacks=[8000, 8080, 8888, 8008], proxyHttpsFallbacks=[444, 4433, 4444, 4443]
verbose: Loading event task-init-answers priority 5
verbose: Loading event task-init-run priority 1
debug: Retrieved from file cache with key init:auth:pantheon:tokens
debug: Cache miss with key init:auth:pantheon:tokens
verbose: Loading event post-instantiate-app priority 5
verbose: Checking for app config at /Users/mmenavas/lando-sites/d8/.lando.yml
verbose: Getting app d-8 from /Users/mmenavas/lando-sites/d8
debug: App d-8 uses config name=d-8, recipe=drupal8, webroot=.
verbose: Emitting event pre-instantiate-app
debug: Event pre-instantiate-app has 0 listeners
verbose: Emitting event post-instantiate-app
debug: Event post-instantiate-app has 9 listeners
verbose: Loading event app-ready priority 5
verbose: Loading event app-ready priority 9
verbose: Loading event app-ready priority 9
verbose: Loading event app-ready priority 5
verbose: Loading event pre-info priority 5
verbose: Loading event post-start priority 1
verbose: Building drupal8 for d-8
debug: Building d-8 with config webroot=., _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, _recipe=drupal8
verbose: Copying drupal8 config from /snapshot/cli/plugins/lando-recipes/drupal8 to /Users/mmenavas/.lando/services/config/drupal8
verbose: Building drupal7 for d-8
debug: Building d-8 with config webroot=., _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, _recipe=drupal8, php=7.1
verbose: Copying drupal7 config from /snapshot/cli/plugins/lando-recipes/drupal7 to /Users/mmenavas/.lando/services/config/drupal7
verbose: Building lamp for d-8
debug: Building d-8 with config webroot=., _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, _recipe=drupal8, php=7.1, php=/Users/mmenavas/.lando/services/config/drupal8/php.ini, database=/Users/mmenavas/.lando/services/config/drupal8/mysql
verbose: Building php 7.1 ad appserver
debug: Building appserver with config type=php:7.1, via=apache, ssl=true, xdebug=false, webroot=., conf=/Users/mmenavas/.lando/services/config/drupal8/php.ini, DB_HOST=database, DB_USER=drupal8, DB_PASSWORD=drupal8, DB_NAME=drupal8, DB_PORT=3306, volumes=[/var/www/.drush], build=[cd /tmp && curl http://files.drush.org/drush.phar -L -o drush.phar && chmod +x drush.phar && ./drush.phar core-status && mv drush.phar /usr/local/bin/drush || composer global require drush/drush:stable], _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, version=7.1
verbose: Copying php config from /snapshot/cli/plugins/lando-services/php to /Users/mmenavas/.lando/services/config/php
verbose: Injecting add-cert.sh from /Users/mmenavas/.lando/services/config/scripts to scripts
debug: Setting default entrypoint for appserver
verbose: Injecting load-keys.sh from /Users/mmenavas/.lando/services/config/scripts to scripts
verbose: Injecting mysql-import.sh from /Users/mmenavas/.lando/services/config/helpers to helpers
verbose: Injecting mysql-export.sh from /Users/mmenavas/.lando/services/config/helpers to helpers
debug: Overriding appserver with DB_HOST=database, DB_USER=drupal8, DB_PASSWORD=drupal8, DB_NAME=drupal8, DB_PORT=3306, volumes=[/var/www/.drush]
verbose: Building mysql latest ad database
debug: Building database with config type=mysql, portforward=true, user=drupal8, password=drupal8, database=drupal8, confd=/Users/mmenavas/.lando/services/config/drupal8/mysql, _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, version=latest
verbose: Copying mysql config from /snapshot/cli/plugins/lando-services/mysql to /Users/mmenavas/.lando/services/config/mysql
debug: Setting default entrypoint for database
verbose: Injecting load-keys.sh from /Users/mmenavas/.lando/services/config/scripts to scripts
verbose: Injecting mysql-import.sh from /Users/mmenavas/.lando/services/config/helpers to helpers
verbose: Injecting mysql-export.sh from /Users/mmenavas/.lando/services/config/helpers to helpers
verbose: Loading event pre-info priority 1
verbose: Loading event post-uninstall priority 5
verbose: Loading event post-start priority 5
verbose: Loading event post-start priority 9
verbose: Loading event post-start priority 5
verbose: Loading event pre-info priority 5
verbose: Loading event pre-start priority 1
verbose: Loading event pre-terminus priority 5
verbose: Loading event post-destroy priority 5
verbose: Added app d-8 to registry with path /Users/mmenavas/lando-sites/d8
debug: Apps in registry: [{"name":"research-admin","dir":"/Users/mmenavas/lando-sites/researchadmin"},{"name":"d-8","dir":"/Users/mmenavas/lando-sites/d8"}]
verbose: Retrieved good apps name=research-admin, dir=/Users/mmenavas/lando-sites/researchadmin, name=d-8, dir=/Users/mmenavas/lando-sites/d8
verbose: Emitting event app-ready
debug: Event app-ready has 4 listeners
verbose: App d-8 has global env. LANDO=ON, LANDO_HOST_OS=darwin, LANDO_HOST_UID=1604669034, LANDO_HOST_GID=120897380, LANDO_HOST_IP=10.152.126.169, LANDO_APP_ROOT=/Users/mmenavas/lando-sites/d8, LANDO_APP_NAME=d-8, LANDO_WEBROOT_USER=www-data, LANDO_WEBROOT_GROUP=www-data, LANDO_WEBROOT_UID=33, LANDO_WEBROOT_GID=33, COLUMNS=256
verbose: App d-8 has global labels. io.lando.container=TRUE
verbose: App d-8 adds process env. LANDO_APP_NAME=d-8, LANDO_APP_ROOT=/Users/mmenavas/lando-sites/d8, LANDO_APP_ROOT_BIND=/Users/mmenavas/lando-sites/d8
verbose: Building compose file at /Users/mmenavas/.lando/tmp/d-8/d-8-1.yml with services. 0=services, 1=volumes, 2=version
verbose: Writing ["services","volumes","version"] to /Users/mmenavas/.lando/tmp/d-8/d-8-1.yml
debug: Full services for /Users/mmenavas/.lando/tmp/d-8/d-8-1.yml image=devwithlando/php:7.1-apache, TERM=xterm, COMPOSER_ALLOW_SUPERUSER=1, PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/var/www/.composer/vendor/bin, LANDO_WEBROOT=/app/., LANDO_SERVICE_NAME=appserver, LANDO_SERVICE_TYPE=php, LANDO_MOUNT=/app, DB_HOST=database, DB_USER=drupal8, DB_PASSWORD=drupal8, DB_NAME=drupal8, DB_PORT=3306, LANDO=ON, LANDO_HOST_OS=darwin, LANDO_HOST_UID=1604669034, LANDO_HOST_GID=120897380, LANDO_HOST_IP=10.152.126.169, LANDO_APP_ROOT=/Users/mmenavas/lando-sites/d8, LANDO_APP_NAME=d-8, LANDO_WEBROOT_USER=www-data, LANDO_WEBROOT_GROUP=www-data, LANDO_WEBROOT_UID=33, LANDO_WEBROOT_GID=33, COLUMNS=256, ports=[80, 443], volumes=[/var/www/.composer, /usr/local/bin, /Users/mmenavas/.lando/services/config/scripts/add-cert.sh:/scripts/add-cert.sh, /Users/mmenavas/.lando/services/config/php/httpd-ssl.conf:/etc/apache2/sites-enabled/000-default.conf, /Users/mmenavas/.lando/services/config/drupal8/php.ini:/usr/local/etc/php/php.ini, $LANDO_ENGINE_SCRIPTS_DIR/lando-entrypoint.sh:/lando-entrypoint.sh, $LANDO_APP_ROOT_BIND:/app:delegated, $LANDO_ENGINE_HOME:/user:delegated, $LANDO_ENGINE_SCRIPTS_DIR/user-perms.sh:/user-perms.sh, /Users/mmenavas/.lando/services/config/scripts/load-keys.sh:/scripts/load-keys.sh, /Users/mmenavas/.lando/services/config/helpers/mysql-import.sh:/helpers/mysql-import.sh, /Users/mmenavas/.lando/services/config/helpers/mysql-export.sh:/helpers/mysql-export.sh, /var/www/.drush], command=docker-php-entrypoint sh -c 'a2enmod rewrite && apache2-foreground', entrypoint=/lando-entrypoint.sh, io.lando.container=TRUE, image=mysql:latest, MYSQL_USER=drupal8, MYSQL_PASSWORD=drupal8, MYSQL_ALLOW_EMPTY_PASSWORD=yes, MYSQL_DATABASE=drupal8, TERM=xterm, LANDO_SERVICE_NAME=database, LANDO_SERVICE_TYPE=mysql, LANDO_MOUNT=/app, LANDO=ON, LANDO_HOST_OS=darwin, LANDO_HOST_UID=1604669034, LANDO_HOST_GID=120897380, LANDO_HOST_IP=10.152.126.169, LANDO_APP_ROOT=/Users/mmenavas/lando-sites/d8, LANDO_APP_NAME=d-8, LANDO_WEBROOT_USER=www-data, LANDO_WEBROOT_GROUP=www-data, LANDO_WEBROOT_UID=33, LANDO_WEBROOT_GID=33, COLUMNS=256, volumes=[data_database:/var/lib/mysql, /Users/mmenavas/.lando/services/config/drupal8/mysql:/etc/mysql/conf.d, $LANDO_ENGINE_SCRIPTS_DIR/lando-entrypoint.sh:/lando-entrypoint.sh, $LANDO_APP_ROOT_BIND:/app:delegated, $LANDO_ENGINE_HOME:/user:delegated, $LANDO_ENGINE_SCRIPTS_DIR/user-perms.sh:/user-perms.sh, /Users/mmenavas/.lando/services/config/scripts/load-keys.sh:/scripts/load-keys.sh, /Users/mmenavas/.lando/services/config/helpers/mysql-import.sh:/helpers/mysql-import.sh, /Users/mmenavas/.lando/services/config/helpers/mysql-export.sh:/helpers/mysql-export.sh], command=docker-entrypoint.sh mysqld, ports=[3306], entrypoint=/lando-entrypoint.sh, io.lando.container=TRUE, , , , version=3.2
verbose: App d-8 has compose files. 0=/Users/mmenavas/.lando/tmp/d-8/d-8-1.yml
info: App d-8 is ready!
debug: App d-8 has config appserver=[d-8.lndo.site], type=php:7.1, via=apache, ssl=true, xdebug=false, webroot=., conf=/Users/mmenavas/.lando/services/config/drupal8/php.ini, DB_HOST=database, DB_USER=drupal8, DB_PASSWORD=drupal8, DB_NAME=drupal8, DB_PORT=3306, volumes=[/var/www/.drush], build=[cd /tmp && curl http://files.drush.org/drush.phar -L -o drush.phar && chmod +x drush.phar && ./drush.phar core-status && mv drush.phar /usr/local/bin/drush || composer global require drush/drush:stable], _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, version=7.1, name=appserver, web=apache, mount=/app, command=[docker-php-entrypoint, sh -c, 'a2enmod rewrite && apache2-foreground'], image=devwithlando/php:7.1-apache, serverConf=/etc/apache2/sites-enabled/000-default.conf, phpConf=/usr/local/etc/php/php.ini, type=mysql, portforward=true, user=drupal8, password=drupal8, database=drupal8, confd=/Users/mmenavas/.lando/services/config/drupal8/mysql, _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, version=latest, service=appserver, description=Run composer commands, cmd=[composer, --ansi], service=appserver, description=Run php commands, service=database, description=Drop into a MySQL shell, user=root, service=appserver, needs=[database], description=Import <file> into database. File is relative to approot., cmd=/helpers/mysql-import.sh, description=The database host, alias=[h], description=The database user, default=root, alias=[u], description=The database name, alias=[d], description=The database password, alias=[p], description=The database port, default=3306, alias=[P], service=appserver, needs=[database], description=Export a database. Resulting file: {DB_NAME}.TIMESTAMP.gz, cmd=/helpers/mysql-export.sh, description=The database host, alias=[h], description=The database user, default=root, alias=[u], description=The database name, alias=[d], description=The database password, alias=[p], description=The database port, default=3306, alias=[P], service=appserver, needs=[database], description=Run drush commands, name=d-8, recipe=drupal8, webroot=., _app=d-8, _root=/Users/mmenavas/lando-sites/d8, _mount=/app, _recipe=drupal8, php=7.1, php=/Users/mmenavas/.lando/services/config/drupal8/php.ini, database=/Users/mmenavas/.lando/services/config/drupal8/mysql
verbose: Additional tooling detected for app d-8
verbose: Adding app cli task composer
verbose: Adding app cli task php
verbose: Adding app cli task mysql
verbose: Adding app cli task db-import <file>
verbose: Adding app cli task db-export
verbose: Adding app cli task drush
verbose: App tooling loaded.
verbose: Recipe custom loaded
verbose: Recipe backdrop loaded
verbose: Recipe drupal6 loaded
verbose: Recipe drupal7 loaded
verbose: Recipe drupal8 loaded
verbose: Recipe joomla loaded
verbose: Recipe laravel loaded
verbose: Recipe lamp loaded
verbose: Recipe lemp loaded
verbose: Recipe mean loaded
verbose: Recipe pantheon loaded
verbose: Recipe wordpress loaded
verbose: Init method github loaded
verbose: Init method pantheon loaded
verbose: Service apache loaded
verbose: Service dotnet loaded
verbose: Service elasticsearch loaded
verbose: Service nginx loaded
verbose: Service node loaded
verbose: Service mailhog loaded
verbose: Service mariadb loaded
verbose: Service memcached loaded
verbose: Service mssql loaded
verbose: Service mongo loaded
verbose: Service mysql loaded
verbose: Service postgres loaded
verbose: Service php loaded
verbose: Service phpmyadmin loaded
verbose: Service python loaded
verbose: Service redis loaded
verbose: Service ruby loaded
verbose: Service solr loaded
verbose: Service varnish loaded
info: Bootstrap completed.
info: Initializing cli
verbose: Emitting event pre-cli-load
debug: Event pre-cli-load has 0 listeners
verbose: Loading cli task composer
verbose: Loading cli task config
verbose: Loading cli task db-export
verbose: Loading cli task db-import <file>
verbose: Loading cli task destroy
verbose: Loading cli task drush
verbose: Loading cli task info
verbose: Loading cli task init
verbose: Loading cli task list
verbose: Loading cli task logs
verbose: Loading cli task mysql
verbose: Loading cli task php
verbose: Loading cli task poweroff
verbose: Loading cli task rebuild
verbose: Loading cli task restart
verbose: Loading cli task share
verbose: Loading cli task ssh
verbose: Loading cli task start
verbose: Loading cli task stop
verbose: Loading cli task version
Usage: lando <command> [args] [options] [-- global options]

Commands:
  composer                 Run composer commands
  config                   Display the lando configuration
  db-export                Export a database. Resulting file: {DB_NAME}.TIMESTAMP.gz
  db-import <file>         Import <file> into database. File is relative to approot.
  destroy [appname]        Destroy app in current directory or [appname]
  drush                    Run drush commands
  info [appname]           Prints info about app in current directory or [appname]
  init [method]            Initialize a lando app, optional methods: github, pantheon
  list                     List all lando apps
  logs [appname]           Get logs for app in current directory or [appname]
  mysql                    Drop into a MySQL shell
  php                      Run php commands
  poweroff                 Spin down all lando related containers
  rebuild [appname]        Rebuilds app in current directory or [appname]
  restart [appname]        Restarts app in current directory or [appname]
  share [appname]          Get a publicly available url
  ssh [appname] [service]  SSH into [service] in current app directory or [appname]
  start [appname]          Start app in current directory or [appname]
  stop [appname]           Stops app in current directory or [appname]
  version                  Display the lando version

Global Options:
  --help, -h  Show help
  --verbose, -v, -vv, -vvv, -vvvv  Change verbosity of output

Unknown arguments: drupal, -vvvv

do initial pass on docs

Other things to include

  • Move CHANGELOG to docs
  • Make sure examples are being surfaced in docs via codesnippet plugin
  • Make sure README is all synced up

Write tutorial on how to add in addtional command like `lando git`

Let's write a tutorial (https://github.com/kalabox/lando/tree/master/docs/tutorials) that a user can follow so that when they are done reading they have a good idea of how to set up additional tooling like lando git. Lets go over

  1. adding a tooling route to an existing service (lando git)
  2. adding a tooling route to a build step service (lando phpunit)
  3. adding a tooling route to a globally installed service (lando gulp)
  4. adding a tooling route to a server installed service (lando phantomjs)

Failed to connect to raw.githubusercontent.com port 443: Connection refused error: Error: 7

First time using lando.

Started lando init with a wp recipe.

Got the following error:

Creating test_appserver_1 ... done
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- 0:00:20 --:--:-- 0curl: (7) F
ailed to connect to raw.githubusercontent.com port 443: Connection refused
error: Error: 7
at ChildProcess. (C:\snapshot\cli\lib\shell.js:143:16)
at emitTwo (events.js:125:13)
at ChildProcess.emit (events.js:213:7)
at maybeClose (internal/child_process.js:887:16)
at Process.ChildProcess._handle.onexit (internal/child_process.js:208:5)
From previous event:
at spawn (C:\snapshot\cli\lib\shell.js:93:10)
at Object.exports.sh (C:\snapshot\cli\lib\shell.js:209:12)
at shCompose (C:\snapshot\cli\lib\compose.js:24:16)
at Object.exports.run (C:\snapshot\cli\lib\compose.js:343:10)
at C:\snapshot\cli\lib\docker.js:163:22
at runCallback (timers.js:800:20)
at tryOnImmediate (timers.js:762:5)
at processImmediate [as _immediateCallback] (timers.js:733:5)
From previous event:
at Object.exports.run (C:\snapshot\cli\lib\docker.js:150:18)
at C:\snapshot\cli\lib\engine.js:526:19
at runCallback (timers.js:800:20)
From previous event:
at Object.exports.run (C:\snapshot\cli\lib\engine.js:525:4)
at AsyncEvents. (C:\snapshot\cli\plugins\lando-services\lib\config.js:148:
31)
at AsyncEvents.handle (C:\snapshot\cli\lib\events.js:109:19)
at C:\snapshot\cli\lib\events.js:170:19
From previous event:
at AsyncEvents.emit (C:\snapshot\cli\lib\events.js:161:18)
at C:\snapshot\cli\lib\app.js:767:23
at runCallback (timers.js:800:20)
From previous event:
at Object.exports.start (C:\snapshot\cli\lib\app.js:766:4)
at C:\snapshot\cli\plugins\lando-core\lib\tasks\start.js:29:28
From previous event:
at Object.run (C:\snapshot\cli\plugins\lando-core\lib\tasks\start.js:25:8)
at C:\snapshot\cli\lib\tasks.js:173:21
From previous event:
at C:\snapshot\cli\lib\tasks.js:172:8
at runCallback (timers.js:800:20)
at tryOnImmediate (timers.js:762:5)
at processImmediate [as _immediateCallback] (timers.js:733:5)
From previous event:
at Object.exports.parseToYargs.command.handler (C:\snapshot\cli\lib\tasks.js:157:6)
at Object.module.exports.self.runCommand (C:\snapshot\cli\node_modules\yargs\lib\comm
and.js:170:22)
at parseArgs (C:\snapshot\cli\node_modules\yargs\yargs.js:920:28)
at Object.get [as argv] (C:\snapshot\cli\node_modules\yargs\yargs.js:860:16)
at C:\snapshot\cli\lib\cli.js:271:7
From previous event:
at Object.exports.init (C:\snapshot\cli\lib\cli.js:238:4)
at C:\snapshot\cli\bin\lando.js:21:20
From previous event:
at Object. (C:\snapshot\cli\bin\lando.js:20:2)
at Module._compile (pkg/prelude/bootstrap.js:1226:22)
at Object.Module._extensions..js (module.js:580:10)
at Module.load (module.js:503:32)
at tryModuleLoad (module.js:466:12)
at Function.Module._load (module.js:458:3)
at Function.Module.runMain (pkg/prelude/bootstrap.js:1281:12)
at startup (bootstrap_node.js:200:16)
at bootstrap_node.js:617:3

Refactor/reorg docs

Let's do a pass on the docs so we can update appropriate sections with the new lando init command. Particularly we should look at...

  • Getting Started Section
  • Add a table of contents to help people pick/choose starting point
    • Starting w/existing codebase
    • Pulling codebase from Github
    • Pulling codebase from Pantheon

These rely upon the creation of other docs that we don't have yet:

  • Configuring lando.yml
    • Using init command
    • Manually creating lando.yml
    • Links to configuration docs
  • Configuring...
    • Recipes
    • Tooling
    • Services
  • Advanced Topics/Follow-up
    • Relevant tutorials
    • Add helpful tutorials to README/index.html

No Such Host

Bug Report

Tell us about your setup

beta-17, ubuntu 16.04

Tell us about the command you were running

lando rebuild
lando start

Tell us about the error you got

john@kalamuna:~/lando/sfrcna$ lando rebuild
? Are you sure you want to rebuild? Yes
Pulling appserver (devwithlando/php:7.0-apache)...
ERROR: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.1.1:53: no such host
Pulling appserver (devwithlando/php:7.0-apache)...
ERROR: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.1.1:53: no such host
Pulling appserver (devwithlando/php:7.0-apache)...
ERROR: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.1.1:53: no such host
Pulling appserver (devwithlando/php:7.0-apache)...
ERROR: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.1.1:53: no such host
Pulling appserver (devwithlando/php:7.0-apache)...
ERROR: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.1.1:53: no such host
error:  Error: Error: 1
    at /snapshot/cli/lib/promise.js:56:17
    at runCallback (timers.js:800:20)
    at tryOnImmediate (timers.js:762:5)
    at processImmediate [as _immediateCallback] (timers.js:733:5)
From previous event:
    at rec (/snapshot/cli/lib/promise.js:42:13)
    at /snapshot/cli/lib/promise.js:50:20
    at ontimeout (timers.js:488:11)
    at tryOnTimeout (timers.js:323:5)
    at Timer.listOnTimeout (timers.js:283:5)
From previous event:
    at /snapshot/cli/lib/promise.js:49:12
    at runCallback (timers.js:800:20)
    at tryOnImmediate (timers.js:762:5)
    at processImmediate [as _immediateCallback] (timers.js:733:5)

Tell us generally about your bug

I've had my laptop on for awhile and this happens, see the comments for the solution, I am just putting this here in case anyone runs into this in the future.

Confusion On Drupal 8 Install With Database Import

Tell us about your setup

Lando version: v3.0.0-beta.19
OS: MacOS 10.12.6

Tell us about your .lando.yml

Paste in the contents of your .lando.yml this is SUPER HELPFUL for us.

name: shrugger
recipe: drupal8
config:
  webroot: .

Tell us about the command you were running

Following: https://docs.devwithlando.io/tutorials/drupal8.html

cd /folder/with/current/drupal8/app
lando init --recipe drupal8
lando db-import db.sql

Tell us generally about your bug

I...can't...read...just saw lando info in the step above the lando db-import info. I will leave my journey below to show you how people who skim install docs or can't read go about setting up their DB for a Drupal 8 site.

Adding the lando info command with a comment after

# Optionally run composer install if needed
lando composer install

might make things clearer for people like me. Also, the caveat about where the db file should be located would be useful to add.


I don't think my issue is a bug, per say, but more of a documentation update. I initially ran the lando init --recipe drupal8 command on a site that I had running on Pantheon and locally through my own LAMP stack. I didn't see any errors while the VM was booting up, and then I tried the db-import command.

My first suggestion is to include "Due to restrictions in how Docker handles file sharing your database dump MUST exist somewhere inside of your app directory." into the Drupal 7, Drupal 8, etc. install guides. I had to find that in the links at the bottom of the Drupal 8 tutorial page after flailing my arms about for 5 minutes or so.

After I placed a SQL file in the root of my app, the lando db-import command seemed to work fine, but the Drupal 8 app directory just kept directing me to "install.php". Once I had entered proper DB credentials, Drupal 8 realized a site had already been imported, but I had to find the DB creds manually in order to get past the D8 install wizard.

lando start
# Guess database connection is "database" from SERVICES
lando mysql
# Search for db names.
mysql > show databases;
# Search for db users.
select user from mysql.user;
# Guess password is the same as user name. 

I realize that some of this information is in config files and can be deduced from those files, but for a lot of users, they might not be as adventurous as me.

How to configure offline development

The issue I have is that I do not fully understand how to configure my global config.yml and host file to get it working offline.

I added .site and .lndo.site to my dnsmasq host file and resolver but it is not working for some reason.

What am I missing?

So the steps that I took are as follows:

  • Configured dnsmasq to work with lndo.site
  • Rebooted OSX to make sure changes are applied
  • Turn off wifi/internet
  • started containers of the project

Result, red labeled url's. While using dig to follow the url, I do get my local ip adress.

Using lando stop, turning on wifi, than running lando start will make it work again.

What am I doing wrong...

MariaDB example is not working.

  • cd LANDO/examples/mariadb
  • lando start

output:

geoff@yep mariadb (master) $ lando start
(node:26794) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: Error: TypeError: this.isRunning is not a function
(node:26794) DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

enclose js hookup

Please complete the following steps. The more steps you complete the more
likely we are to address your issue!

  1. Please review the current list of issues to make sure you are not submitting a duplicate.
  2. Please tag your issue appropriately. Please review the tagging criteria.
  3. Based on the issue type tag selected above please fill in the relevant section below.

Bug Report

Tell us about your setup

What is your lando version and operating system?

Example: v3.0.0-alpha1 on Windows 10 Professional

Have you previously installed lando? If so, what version?

Example: Yes, I've installed lando v3.0.0-alpha4

Tell us about your bug

Give a brief description of what happened, including any error messages that appeared.

Example: I tried to create a pantheon site but got a LowerCase not defined exception

Please detail the steps we can take to replicate this bug. Be as detailed as possible.

Example:

  1. Started up GUI
  2. Clicked on my Pantheon account in the sidebar
  3. Selected a site and an environment
  4. Kept the default create options and pressed submit

Tell us more

Could better documentation have prevented this issue? if so what should we change?

Does this bug prevent you from using lando?

Feature/Enhancement Request

Please explain your request and its importance in the form of a user story.

Example: As a lando user who works with Drupal sites that have large databases, I want the option to exclude unnecessary database tables from being pulled when I update my site because I want faster "site pull" actions.

Please provide some detail on how lando can help solve this problem

Example: Place an option on the "site pull" screen to exclude cache tables.

Add potentially helpful and commented out optional sections to recipes

As a developer i often wish to go above and beyond the pre configured recipes provided by lando to add in additional things like build steps, front end tooling, etc.

Let's add a few of these common use cases to all our recipe examples so people can get rolling super fast. I think we are going to want to leave this sections commented out by default and they should link to relevant tutorials if needed. Here are some obvious things

  1. How to override the recipe appserver to add in some extra things:
    a. Environmental variables
    b. build steps (things keyed by "extras" and "build"
    c. pre-run scripts.
  2. How to set up static ports for the DB (eg portforward: 3531)
  3. Set up front end tooling
  4. Set up some other common things like phpmyadmin, redis, etc

Might be worth holding off on this until the rest of the documentation is done

lando start fails when trying to create network: "could not find an available, non-overlapping IPv4 address pool", lets get lando to throw a helpful error message here with a link to the appropriate docs

Bug Report

  • lando v3.0.0-beta.22
  • Docker version 17.09.0-ce, build afdb6d4
  • docker-compose version 1.17.0-rc1, build a0f95af
  • Fedora 25 (Workstation Edition)
  • In a shared office space with unknown network configuration, but I've never had any other issues with docker networking.
  • Existing drupal8 git repo.
  • .lando.yml is stock drupal8 recipe. (webroot: docroot)
lando start
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
Creating network "landoproxyhyperion5000gandalfedition_edge" with driver "bridge"
ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
error:  Error: Error: 1
    at /snapshot/cli/lib/promise.js:56:17
    at runCallback (timers.js:800:20)
    at tryOnImmediate (timers.js:762:5)
    at processImmediate [as _immediateCallback] (timers.js:733:5)
From previous event:
    at rec (/snapshot/cli/lib/promise.js:42:13)
    at /snapshot/cli/lib/promise.js:50:20
    at ontimeout (timers.js:488:11)
    at tryOnTimeout (timers.js:323:5)
    at Timer.listOnTimeout (timers.js:283:5)
From previous event:
    at /snapshot/cli/lib/promise.js:49:12
    at runCallback (timers.js:800:20)
    at tryOnImmediate (timers.js:762:5)
    at processImmediate [as _immediateCallback] (timers.js:733:5)

Expounding upon supporting versions in mariaDB doc

Tell us about your setup
OS = macOS Sierra Version 10.12.6 , Lando version = lando-v3.0.0-beta.24.dmg

Tell us about your .lando.yml

Paste in the contents of your .lando.yml this is SUPER HELPFUL for us.

Example:

name: dotcom
recipe: drupal7
services:
  appserver:
    build:
      - "curl -sS https://platform.sh/cli/installer | php"
    config:
      conf: php.ini
  database:
    portforward: 8993
  cache:
    type: redis
    persist: true
    portforward: 6379
tooling:
  platform:
    service: appserver
    description: Run Platform CLI commands
    cmd:
      - /var/www/.platformsh/bin/platform
    options:
      passthrough: true
  redis-cli:
    service: cache
config:
  via: nginx
  webroot: _www
  database: mariadb:10.1

Tell us about the command you were running

lando rebuild -y 
# checked to see if everything was running
# open up new terminal 
docker ps -a 
# notice that i had mariadb:10.1 not running
8366fc3e671a        mariadb:10.1               "/lando-entrypoint..."   2 minutes ago       Exited (1) 2 minutes ago                                                                          dotcom_database_1
docker rm 8366fc3e671a
# did another lando  rebuild -y
# same issue, so i checked logs
lando logs 

Tell us about the error you got

database_1   | 2017-11-15 16:01:10 140537640757184 [Note] InnoDB: Using SSE crc32 instructions
database_1   | 2017-11-15 16:01:10 140537640757184 [Note] InnoDB: Initializing buffer pool, size = 384.0M
database_1   | 2017-11-15 16:01:10 140537640757184 [Note] InnoDB: Completed initialization of buffer pool
database_1   | 2017-11-15 16:01:10 140537640757184 [Note] InnoDB: Highest supported file format is Barracuda.
database_1   | InnoDB: No valid checkpoint found.
database_1   | InnoDB: A downgrade from MariaDB 10.2.2 or later is not supported.
database_1   | InnoDB: If this error appears when you are creating an InnoDB database,
database_1   | InnoDB: the problem may be that during an earlier attempt you managed
database_1   | InnoDB: to create the InnoDB data files, but log file creation failed.
database_1   | InnoDB: If that is the case, please refer to
database_1   | InnoDB: http://dev.mysql.com/doc/refman/5.6/en/error-creating-innodb.html
database_1   | 2017-11-15 16:01:10 140537640757184 [ERROR] Plugin 'InnoDB' init function returned error.
database_1   | 2017-11-15 16:01:10 140537640757184 [ERROR] Plugin 'InnoDB' registration as a STORAGE ENGINE failed.
database_1   | 2017-11-15 16:01:10 140537640757184 [Note] Plugin 'FEEDBACK' is disabled.
database_1   | 2017-11-15 16:01:10 140537640757184 [ERROR] Could not open mysql.plugin table. Some plugins may be not loaded
database_1   | 2017-11-15 16:01:10 140537640757184 [ERROR] Unknown/unsupported storage engine: innodb
database_1   | 2017-11-15 16:01:10 140537640757184 [ERROR] Aborting
database_1   | 

Tell us generally about your bug

Whenever I tried to run lando mysql i would get this error

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2 "No such file or directory")

which told me that my database service isnt starting

Tell us more

Could better documentation have prevented this issue? if so what should we change?
In slack Pirog explained that it was because i was jumping versions from high -> low which could cause this problem and that i would need to run a lando destroy and then lando rebuild to resolve the situation.

Feature/Enhancement Request

Please explain your request and its importance in the form of a user story.

As a lando user who works with Drupal sites, I want more elaboration on the documentation for mariadb explaining that even though Lando supports older versions if you edit your lando.yml file from a higher version to a lower version there could be issues with your build
Please provide some detail on how lando can help solve this problem

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.