fluxcd
Document minimum version required for Bitbucket Server
I was working with a user who is on Bitbucket Server or self-hosted, and it's a quite old version. We spent a while looking at the issue with bootstrap bitbucket-server only to find out after a lot of struggle that Bitbucket 6.3.2 is from 2019 and almost certainly doesn't work how today's Bitbucket Server does, which probably explains the problems that we were having.
Is there a minimum version of Bitbucket Server requirement for Flux? It mentions here some notes about the version, but nothing is clear, we are using Bitbucket Server but it appears there is an issue with very old versions, or we didn't understand the mapping between project/repo and repository owner in Flux bootstrap. The place where I'd expect to see a minimum version listed:
https://fluxcd.io/flux/installation/#bitbucket-server-and-data-center
I suspect that some structures have changed since 5 years ago, and this probably explains our issue. It's probably not worth tracking down this issue with such an old version of Bitbucket, the user can't upgrade and might work around it.
I do not know if we selected correctly all the bootstrap parameters correctly, at one point we got an error message about stash not supporting subrepositories and it wasn't clear to me from the project structure whether we are using sub repository or not; I think there was a project, an owner, and also a repo name, but they did not seem to be hierarchical and we saw two different path names based on whether it was an https url or git/ssh. I'm sorry I can't be more descriptive about the error, it looked like an issue with finding the project, possibly related to authentication. We couldn't resolve it without switching to the generic bootstrap, and we wound up building the resources by hand in the cluster because of the network isolation.
I recommended an upgrade for Bitbucket soon, but the user will probably not be able to upgrade Bitbucket while they still hope to upgrade Flux ASAP, since they are on just as old Flux and we don't charge anything for upgrades 🤠. I'm not sure what else we can do for them now, besides adding a recommendation for a minimum version of Bitbucket to the docs, if there is one we have tested.
We never tested against 6.3.2. The oldest version that we have used for testing is 7.14.0. We are now using 8.7.0 in our integration tests, but 7.14.0 should still work if you do not use http access tokens which were introduced in 7.21. But that's not ideal, so I think that our recommendation should be to use the last major version, so 8.0.
Usually what breaks bitbucket-server bootstrap are api changes and many happened since 2019.
