Allow ssh/config to accept string, or array of strings

[Burgestrand]

Note

I made this PR rogue, in the sense that I forked and made a change that seems to have worked without discussing this change with anybody else first. I don't necessarily expect this to be merged. 🙂

On the topic of passing through config I would like to use this option, so that I can embed a config/ssh_config with my project and have Kamal use it, instead of having to modify my global ~/.ssh/config.

There are the following changes in this PR:

• Actually pass ssh/config through to the SSH options, so that the documentation is accurate.
• Modify run_over_ssh (shelling out to SSH) to actually use the config file if one is passed, or none if false is passed
• Modify the validation to allow a path to a config file, in addition to the boolean
• Modify the documentation because, we don't actually support an array of files

Supporting a string path allows support for using an ssh_config-file in Kamal, similar to this:

Host web
  HostName 8.8.8.8
  User kamal

Host accessories
  HostName 10.0.0.3
  User kamal
  ProxyJump web

... which then allows you to specify the hosts using the names, rather than IPs. The same file can also be used when SSHing in manually, using ssh -F ssh_config web.

This is reviewable commit-by-commit.

To do

• Main question: is this change wanted?
• Add tests to ensure this keeps working.

[Burgestrand]

FYI I force-pushed, because I added tests to each commit.

[GideonStowell]

@Burgestrand any updates on this?
I ran into this as well and very interested in getting this functionality added.

[Burgestrand]

For now this got me far enough to notice there's more to it to get it to work for a few specific commands.

I don't know which parts need to change to get e.g. log following to respect this flag. I won't be working on this for at least a few weeks, but if you want to pick up where I left off absolutely feel free.

On top of that I would say this is still missing the blessing of the maintainers of Kamal, i.e. is this something they'd like to merge and ultimately support.

[GideonStowell]

I would hope it is blessed by the maintainers because @jeremy linked this PR when I raised an issue abt the incorrect documentation related to ssh config.

Is the issue time or other resources? I don't have my ruby merit badge but I'd be willing to sponsor some hours if that's a motivator.

[Burgestrand]

Is the issue time or other resources? [...]

Motivation and time expenditure! I've been experimenting with Kamal for future projects, but paid client work got in between and I'm not using Kamal for them in the near future 😊

Regardless, I had some time to think about the "interactive commands" problem in the car today and figured "how hard can it be?", so now this PR also has some adjustments so that e.g. kamal app logs --follow work properly.

In doing that work I noticed the ssh CLI doesn't accept more than one ssh_config through -F, so I opted to remove the array option as a minimum common supported option between SSH and SSHKit.

[GideonStowell]

@djmb @Sija @jeremy
Any of you able to review these changes?