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.