update and set up a better tutorial

[rubelyn]

I just created a drupal 8 site from scratch. Drupal 8 is new to me and I had some troubles getting it to work locally. I understood that I could make it work by using terminus so that's what I tried.

I was following these tutorials/urls:

https://github.com/pantheon-systems/drush-config-workflow/blob/master/INSTALL.md

and specifically in this section: "Make a Local Clone of a Pantheon Site"

https://github.com/pantheon-systems/terminus/blob/master/README.md

It was quite troublesome and I want to share the problems that I ran into so you can fix this and update the tutorial and terminus.

(BTW I have a new macbook pro, running el capitan and have the newest versions of everything, among drush 8.)

After I had cloned clown terminus I ran: ./bin/quickstart youintervene /Users/dudde/Projects/youintervene

which gave me this:

Installing Terminus

% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 148 0 148 0 0 269 0 --:--:-- --:--:-- --:--:-- 272 100 591 0 591 0 0 847 0 --:--:-- --:--:-- --:--:-- 847 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0Warning: Failed to create the file /Users/dudde/bin/terminus: No such file or Warning: directory curl: (23) Failed writing body (0 != 16384) Could not download Terminus.

I had a look inside the quickstart file and saw that it was this command: curl https://github.com/pantheon-systems/cli/releases/download/0.5.5/terminus.phar -L -o $HOME/bin/terminus

I tried to run it manually in the terminal and I got the same error msg.

Then I googled and was able to install terminus using this command:

curl https://github.com/pantheon-systems/terminus/releases/download/0.10.3/terminus.phar -L -o /usr/local/bin/terminus && chmod +x/usr/local/bin/terminus`

Then after that I tried to run this command again: ./bin/quickstart youintervene /Users/dudde/Projects/youintervene

This time it complained about: Mysql credentials incorrect. Please run again with --user and --pw.

so I ran again with: ./bin/quickstart youintervene /Users/dudde/Projects/youintervene --user root --pw root`

which gave me complaining about auth login

[2016-02-13 18:45:49] [warning] The terminus auth login command has an invalid synopsis part: [--debug] cmd: 'terminus auth login' token: '[--debug]' [2016-02-13 18:45:49] [info] Please visit the Dashboard to generate a machine token: https://dashboard.pantheon.io:443/machine-token/create?client=terminus&device=duddes-MBP url: ' https://dashboard.pantheon.io:443/machine-token/create?client=terminus&device=duddes-MBP '

This should be mentioned in the tutorials, anyways I was able to do this thanks to the explanation.

After that I tried again with:

./bin/quickstart youintervene /Users/dudde/Projects/youintervene --user root --pw root` and I started to get this error message:

[2016-02-13 18:51:17] [error] 'site connection-mode' is not a registered command. See 'terminus help'. cmd: 'site connection-mode' Could not use terminus to determine the connection mode of the dev environment of the Pantheon site 'youintervene'.

I googled about it and tried to run this command but it never worked. So finally I commented out the following lines inside the quickstart file to be able to make everything work:

Check our connection mode CONNECTION_MODE=$(terminus site connection-mode --site="$PANTHEON_SITE" --env="$SITE_ENV") aborterr "Could not use terminus to determine the connection mode of the $SITE_ENV environment of the Pantheon site '$PANTHEON_SITE'." $DEBUGMSG "$CONNECTION_MODE" echo "$CONNECTION_MODE" | grep -qi git if [ "$?" != "0" ] then if $FORCE then terminus site connection-mode --site="$PANTHEON_SITE" --env="$SITE_ENV" --set=git aborterr "Could not use terminus to set the connection mode of the $SITE_ENV environment of the Pantheon site '$PANTHEON_SITE' to 'git'." CONNECTION_MODE=$(terminus site connection-mode --site="$PANTHEON_SITE" --env="$SITE_ENV") aborterr "Could not use terminus to determine the connection mode of the $SITE_ENV environment of the Pantheon site '$PANTHEON_SITE'." else $ERROR "The site $PANTHEON_SITE is not in 'git' mode. Fix this via 'terminus site connection-mode --site="$PANTHEON_SITE" --env="$SITE_ENV" --set=git', or run again with --force to force-switch to 'git' mode." >&2 exit 1 fi fi $DEBUGMSG "$CONNECTION_MODE"

https://pantheon-systems.desk.com/agent/case/55339

[stevector]

If this repo gets updated it should also include tests that verify the behavior.