Problem/Motivation

#2988211: Create a path that will always download latest recommended Drupal zip or tarball has made new download paths available:

We should update core/INSTALL.txt to use the .tar.gz path.

Note, this will only work in tandem with the quick-start command after Drupal 8.6.0 is released and becomes the recommended version of Drupal.

Steps to reproduce

Proposed resolution

I think this can be done in #3086655: Add composer instructions to INSTALL.txt

Remaining tasks

See #21

User interface changes

API changes

Data model changes

Release notes snippet

Comments

grasmash created an issue. See original summary.

grasmash’s picture

Status: Active » Needs review
StatusFileSize
new1.16 KB
grasmash’s picture

StatusFileSize
new1.12 KB

Updated patch does not leave behind tarball.

geerlingguy’s picture

Trying these commands, I get the following:

~/Downloads/drupal $ php core/scripts/drupal quick-start
Could not open input file: core/scripts/drupal

~/Downloads/drupal $ ls core/scripts/
cron-curl.sh                 dump-database-d7.sh          js                           transliteration_data.php.txt
cron-lynx.sh                 dump-database-d8-mysql.php   password-hash.sh             update-countries.sh
db-tools.php                 generate-d6-content.sh       rebuild_token_calculator.sh
drupal.sh                    generate-d7-content.sh       run-tests.sh
dump-database-d6.sh          generate-proxy-class.php     test

It seems like those commands might require 8.6.x which is not yet released, so _technically_ this can't be fully tested.

One last note: I remember some discussion over using tar vs unzip in the issue which generated the quick-start command. I'll try to see if there were any caveats to switching.

geerlingguy’s picture

Status: Needs review » Needs work
Related issues: +#2911319: Provide a single command to install & run Drupal

Adding related issue.

And regarding unzip vs tar... this was because of Windows; a couple comments mentioned it's more likely to be available than tar in a Windows environment—most notably:

It defaulted to using unzip as that is more readily available on Windows.

From: #2911319-121: Provide a single command to install & run Drupal.

Is there a 'latest zipped archive' release URL as well?

grasmash’s picture

@geerlingguy Yes

this will only work in tandem with the quick-start command after Drupal 8.6.0 is released and becomes the recommended version of Drupal.

As far as zip vs tar, the unzip command doesn't have a corollary for --strip-components.

Executing:

curl -sSL https://www.drupal.org/download-latest/zip --output drupal.zip
unzip drupal.zip -d drupal

Results in extraction to drupal/drupal-8.5.6/, which makes it impossible to provide a static set of commands to follow. IMO that's a bad user experience.

Should we provide a set of commands for Linux & MacOS and a separate set for Windows?

grasmash’s picture

StatusFileSize
new2.07 KB
grasmash’s picture

Status: Needs work » Needs review

I've added separate command sets for MacOS/Linux and Windows.

The MacOS/Linux commands use the tar.gz. This these commands do not require manual string replacement and will download the smaller tar.gz archive faster. IMO, this justifies listing two sets of commands.

The Windows commands use the zip file. This does require manual string replacement and will take longer to download the archive.

If we want to simplify this, I'd look into have drupal.org generate an archive that has a consistent (not version dependent) directory structure.

seangambierross’s picture

I've picked this up at #uoe-d8-contribution

seangambierross’s picture

I've applied and tested this patch.
https://www.drupal.org/files/issues/2018-08-16/2992879-quick-start-docs-...
Install.txt has been updated with the appropriate MacOS/Linux and Windows commands.

Reviewed and and happy with this patch.

seangambierross’s picture

Status: Needs review » Reviewed & tested by the community
geerlingguy’s picture

Status: Reviewed & tested by the community » Needs review

Not 100% sure if this should be RTBC yet; I think the main concern I have is this splits off the directions between Mac/Linux users and Windows users... which reverses course on the initial purpose of "one set of instructions no matter who you are".

It's nice to be optimized for the best use case, but this would be yet another example where those using Windows will end up being 2nd class citizens, in that their instructions are later in the README, and their instructions are not the same as the instructions the non-Windows users have (meaning fewer people would be using that set of instructions, it's less likely that someone who could quickly make an impact on fixing things would notice that the Windows download link isn't working vs. the one for Mac/Linux, etc.).

I'm not fully opposed to this patch... but I do think it's something we should get more input on, since we ended up spending significant energy (and helping a few first-time Windows-using contributors get their feet wet at the last DrupalCon) making sure the instructions worked on all major platforms, and not just the POSIX-centric ones.

Version: 8.6.x-dev » 8.8.x-dev

Drupal 8.6.x will not receive any further development aside from security fixes. Bug reports should be targeted against the 8.8.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.9.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.7 was released on June 3, 2020 and is the final full bugfix release for the Drupal 8.8.x series. Drupal 8.8.x will not receive any further development aside from security fixes. Sites should prepare to update to Drupal 8.9.0 or Drupal 9.0.0 for ongoing support.

Bug reports should be targeted against the 8.9.x-dev branch from now on, and new development or disruptive changes should be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.2.x-dev

Drupal 8 is end-of-life as of November 17, 2021. There will not be further changes made to Drupal 8. Bugfixes are now made to the 9.3.x and higher branches only. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.15 was released on June 1st, 2022 and is the final full bugfix release for the Drupal 9.3.x series. Drupal 9.3.x will not receive any further development aside from security fixes. Drupal 9 bug reports should be targeted for the 9.4.x-dev branch from now on, and new development or disruptive changes should be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.9 was released on December 7, 2022 and is the final full bugfix release for the Drupal 9.4.x series. Drupal 9.4.x will not receive any further development aside from security fixes. Drupal 9 bug reports should be targeted for the 9.5.x-dev branch from now on, and new development or disruptive changes should be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

needs-review-queue-bot’s picture

Status: Needs review » Needs work
StatusFileSize
new160 bytes

The Needs Review Queue Bot tested this issue. It either no longer applies to Drupal core, or fails the Drupal core commit checks. Therefore, this issue status is now "Needs work".

Apart from a re-roll or rebase, this issue may need more work to address feedback in the issue or MR comments. To progress an issue, incorporate this feedback as part of the process of updating the issue. This helps other contributors to know what is outstanding.

Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.

Version: 9.5.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

quietone’s picture

quietone’s picture

Issue summary: View changes
Status: Needs work » Active

Downloading via a tarball is being removed. So, the instructions should be changed to using composer.

Version: 11.x-dev » main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Read more in the announcement.

quietone’s picture

Issue summary: View changes
Status: Active » Postponed
quietone’s picture

Status: Postponed » Closed (won't fix)

So, this hasn't been a response to the questions in #12 for 7 years. And @geerlingguy makes a valid point that having separate instructions for *nix family and Windows isn't ideal. However, we now only promoting installs via composer so this is now a won't fix. The wget commands are being removing in #3086655: Add composer instructions to INSTALL.txt and that is eligible for backport.

Therefor, I have updated credit and am closing this one.

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.