Adding a getit script for easier Docker files download

[vcampitelli]

Description

This adds a getit script to simplify downloading Docker files to start an instance. Instead of running:

curl -o docker-compose.yml https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/.env

One would only need to do:

curl -s https://fusionauth.io/getit | sh -s -- --download

Secondary scenario

I know we only have to download those 2 files right now, but we've been copying them into every quickstart demo app. So if we'd ever want to update those files, we'd have to replace them in every single repo. In this scenario, we'd just need to add a step to the quickstart article with the command below to download files with Kickstart settings:

curl -s https://fusionauth.io/getit | sh -s -- --download-kickstart         

Screenshot

This is how it looks like:

Redirect

@mooreds said we could add this a redirect script to our website to have it on fusionauth.io/getit. Can we do that?

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1205100644092785

[robotdan]

I like this idea in theory.

Some thoughts:

• It is less transparent than what we have today. What we are asking the user to download is now opaque.
• It now requires a managed redirect that is not managed in GitHub along with the other source code.
  • If we want a short URL, we could use a common online URL shortener. I know it isn't as cool as using our own domain.
• There isn't anything in the URL that would indicate I'm downloading a Docker compose configuration.
  • curl -s https://fusionauth.io/getit | sh - seems like the arg should be --docker-compose or something like that?
• It seems code like this should belong in fusionauth-install? It could then cover all install use cases, not just for Docker compose. I would not generally not think to look for download scripts in fusionauth-container.
  • https://github.com/FusionAuth/fusionauth-install

[mooreds]

It is less transparent than what we have today. What we are asking the user to download is now opaque.

I like the idea of telling people to review the shell script. We used to have that messaging on the download pages. (Here's a install script, but please feel free to read the script before executing it.)

It now requires a managed redirect that is not managed in GitHub along with the other source code.

It is managed under fusionauth-site (or is planned to be).

It seems code like this should belong in fusionauth-install?

Ooh, that's a good call. I told @vcampitelli that it should go here, but I like fusionauth-install better. I do want to make sure this isn't ballooning in scope, so I'd recommend keeping it to a docker install for now.

[lyleschemmerling]

I like the idea of telling people to review the shell script

I sort of assume people don't read, especially shell, though I don't think it hurts to say they should. With the colors and stuff it is a little less legible than ideal for that, so I think we should be hyper verbose in the script's help doc as that is the thing most people will interact with

[lyleschemmerling]

approve of the script with more words in the help. No notes or where it should live or get hosted

[vcampitelli]

Moved this to FusionAuth/fusionauth-install#13