Documentation: Docker 23.0.0 required to deploy Atlantis with ACI

[patrick-merchant]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request. Searching for pre-existing feature requests helps us consolidate datapoints for identical requirements into a single place, thank you!
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

---

Overview of the Issue

If using Docker pre-23.0.0 (e.g. Docker Desktop uses 20.10.23), Atlantis releases since v0.23.0 cannot be deployed using Azure Container Instances, returning the following error:

Error: The image 'runatlantis/atlantis' is not accessible. Please check the image and registry credential.

Apparently ACI requires images to have a manifest (as per the answer in https://learn.microsoft.com/en-us/answers/questions/1179992/(inaccessibleimage)-the-image-docker-io-presearch).

Looks related to this issue around OCI image types not having a manifest: moby/moby#43126.

Fix has been added in docker 23.0.0 docker/cli#3990.

Reproduction Steps

With docker < 23.0.0:

Run docker manifest inspect ghcr.io/runatlantis/atlantis:latest

Result: no such manifest: ghcr.io/runatlantis/atlantis:latest

Environment details

• Atlantis version: v0.23.3
• Deployment method: Azure Container Instances

Describe the solution you'd like

It could be helpful to have a note in the deployment docs at https://www.runatlantis.io/docs/deployment.html#microsoft-azure, specifying that - for ACI deployment - either docker 23.0.0 is required or the image must be pulled and pushed to a private registry like ACR.

[jamengual]

@patrick-merchant feel free to propose a PR

[patrick-merchant]

@jamengual PR here: #3293

[ausfestivus]

Just for some further info about this, we raised this issue with MS via Premier Support to try and get some traction with the product team in the hopes they might actually fix the issue in ACI.

WONT FIX was the answer.

Thanks for your reply. Per checking with our product engineer, I‘m afraid that there are no plans to have ACI support images with no manifests. It's a by design limitation.

The workaround is to setup an ACR with the Atlantis image and use the image from that instead.

[ausfestivus]

FYI, I pushed back on MS about this situation. This morning MS has advised me that the underlying issue in ACI which caused this has been fixed.

I tested it out and I was able to run Atlantis v0.23.5 directly without going through ACR.

@jamengual did you want a new issue for the doco update or happy to reopen and run with this issue?

[jamengual]

ohhh ok, let's do a doc update please and link this issue.

thanks @ausfestivus