EDIT: Advised URL now updated to reflect Stack 2.15.5 and avoid redirection.
EDIT2: Stack users are recommended to upgrade to Stack 2.15.5. (For people using GHCup to manage versions of Stack, an update to GHCup’s metadata is in hand.)
Users of Stack 2.15.3 or earlier should update their config.yaml file to set the configuration option:
There is no command. For people not familar with config.yaml its location is reported by stack path --global-config. It can be edited like any other text file.
My intention is that the next release of Stack will have a sensible default URL once again and this need for a configuration will soon pass.
Thankfully @mpilgrem was on hand to figure this out. I overlooked the fact that stack relies directly on the old url when planning the migration.
I will be able to look at this in more detail next week.
Stack users: how much of an impact does this have on you? I will fix things up so that the old url continues working, but it will need to be shut down eventually. What is a reasonable time frame? Keeping in mind that it is already configurable and future releases will have a functional default.
The next version of stack will use an updated URL. I hope to have the correct URL determined by tomorrow, then @mpilgrem can cut a release.
Hm! That URL is under our control and could probably be (permanently) updated to point to the new data source. I’ll look into that.
The data migration has completed now! That means I can start working on fixing up the old URLs very soon. There were a few errors during the process that I need to understand first, however.
FYI the question I want to answer is whether or not I should stick with stackage-haddock.haskell.org as the hostname to use, or if I should pick a name that reflects the specific use case.
The linked documentation is for the ‘stable’ version of Stack (being 2.15.3), is accurate for that version and includes the interim work-around. The documentation for the ‘latest’ version of Stack (being the master branch of the repository) is at: Configuration (project and global) - The Haskell Tool Stack. The plan of action is this:
@chreekat confirms the most appropriate URL, when things are settled at Stackage’s end
A Stack 2.15.5 is released as a bug fix (perhaps also with some other bug fixes)
This post (and others elsewhere) are updated to reflect developments.
The GHCup project is encouraged to view Stack 2.15.5 as its current ‘recommendation’.
The existing URL is an s3.amazonaws.com URL that points at a bucket owned by FP Complete. As part of the Stackage handover, the content has moved to a new bucket so that FP Complete can eventually remove theirs. The new bucket isn’t even on S3, so I just assumed there was no way to point the old URL at the new bucket.
The original issue in this thread should now be resolved. The old URL for snapshots.json should now work for the rest of the transition period. I sync snapshots.json back to the old bucket whenever it gets updated.
@chreekat, thanks. I plan to release Stack 2.15.5 very soon. @hasufell and I are discussing something unrelated (Stack #6526) which I would like to include in the same bug fix release, but if that causes any significant delay it can wait.