Multi-tenant repo: why the tenant deployment GitRepository has to be definied twice?
I noticed that the facebooc-deploy tenant Git repository is declared twice:
- [flux-fleet]/projects/base/facebooc/facebooc-deploy-gitrepository.yaml creating a facebooc-deploy kubernetes object and;
- [tenant-repo/facebooc-deploy]/flux/base/facebook-repository.yaml creating a facebooc kubernetes object.
I could change the name of the GitRepository CRD declared in the tenant Git repository to match the name of the one declared in the Flux Fleet Git repository and everything works fine. However, when I delete the second declaration (the one in the tenant repository) as it is pointing to its own parent repository and its equivalent has already been declared in the flux infrastructure, the kustomization reconciliation fails. Obviously the GitRepository CRD in the Git tenant deploy repository is required. I do not understand why?
Can you help me to figure out the purpose of this second GitRepository declaration? I do not see anything in the flux documentation that can explain what is the underlying mechanism.
Thanks,
Béatrice
Answers
-
Also, during my tests, I used the same namespace (facebooc) on every CRD on both the flux fleet Git repository manifests and the tenant deployment Git repository manifests.
0 -
My apologies, I forgot to update the kustomization manifest in the Git tenant deployment repository accordingly.
I confirm that the everything works without the 2nd GitRepository (the one in the Git tenant deployment repository).
Thanks
0 -
Hi @bauger , thanks for confirming that the lab worked for you.
Regards,
Luis.0 -
@bauger I had designed the repository structure based on this resource available https://github.com/fluxcd/flux2-multi-tenancy. At the time of authoring this course, there was not a lot of information I could find from the official documentation (which may have changed now). This is more of a design pattern and not the standard/only way of achieving multi tenancy. I am sure this could be approached in different ways as well.
I would review the code and update this thread if there is need for the tenant repo CRD.
0 -
@luisviveropena and @gouravshah,
thanks for your answers.Unfortunately, at this point I am not able to get a multi-tenant FluxCD infrastructure working with the instavote deployment. I focused on the https://github.com/lfs269/facebooc-deploy.git and the https://github.com/lfs269/flux-fleet.git, as for myself too, the FluxCD documentation is confusing: the https://github.com/fluxcd/flux2-multi-tenancy point to itself rather than a real tenant deployment repository and the FluxCD documentation does not explain neither if there is some expected repository architecture to get flux controllers working. It let me confused because I cannot follow a tool mechanism logic to understand how to deploy, neither I can follow a design pattern logic. For example, is 'app' refering to microservice? And what could be the setting implications in terms of repository structure/k8s manifest declarations? Also, reading through https://fluxcd.io/docs/flux-e2e I could not see how to combine it with https://fluxcd.io/docs/guides/repository-structure...
From here, I will follow the last section (with Flagger) without applying in to the instavote case. if I could, I will try with the facebooc-deploy use case.
Thanks,
Béatrice
0 -
@bauger I have reviewed the code based on your earlier comments. There is a reason why the same Git repo is referenced in two places. Here are my comments
[flux-fleet]/projects/base/facebooc/facebooc-deploy-gitrepository.yaml
With the context of this if you observe the code in ... projects/staging/facebooc-deploy-kustomization.yaml--- apiVersion: kustomize.toolkit.fluxcd.io/v1beta1 kind: Kustomization metadata: name: facebooc-deploy namespace: facebooc spec: path: ./flux/staging
You would notice that its calling for kustomization in flux/staging path. This is for Tenant/Project onboarding.
Consequently , with the context of
[tenant-repo/facebooc-deploy]/flux/base/facebook-repository.yaml
this is in reference to facebooc-deploy/flux/staging/facebooc-kustomization.yaml
which is then referring to the same Git repo, but calling code from a different path as follows
--- apiVersion: kustomize.toolkit.fluxcd.io/v1beta1 kind: Kustomization metadata: name: facebooc namespace: flux-system spec: path: ./kustomize/facebooc/staging
this is where the actual application would get deployed.
So in summary, the same repo contains both project/tenant onboarding code + application deployment code. This is just a design pattern. You could also maintain the application deployment code somewhere else (e.g. in the application code repo). I hope this helps. If you have follow up questions, would be glad to help.
1 -
Thanks for your answer. At this point, I still have the same feeling that from a learning perspective this design pattern is confusing me for two reasons:
- The mix of applications and microservices deployments in the same git repository does not help to clarify what should be a good practice to deploy and maintain code; as it is, this design pattern seems to be at the transitional stage from monolith to microservices. I can understand to get a git repository (deployment and/or development) by team, or a git repository by application and one by microservice. Also, understanding developer, devops and sysadmin accountability with such infrastructure matters for me.
- Understanding the transition from single-tenant to multi-tenant meant for me to get if fluxCD imposes a specific folder structure. Following a very simple example like with this post (part 1 and part 2) helped me to realize that fluxCD is flexible and I would not have to follow a strict structure in the git repositories (the tenant one and the flux-fleet one).
Thanks
0 -
You are right when you say FluxCD does not impose any specific structure and offers flexibility as to how you design your multi tenant setup. That is also the reason for confusion as there are different design patterns which have evolved to address it with different goals.
Comparing atleast two of those, I arrived at the design which I have proposed and followed as part of this course.
The choice would also come down to who is responsible for what in a organisation. For example, some times its the developers who would maintain both, the application code, along with deployment code. In other orgs, deployment code is the responsibility of a SRE/Devops Engineering Teams.
My suggestion is
- you come up with the best practices and ownership patterns that you would like to follow.
- Design the repositories accordingly
- Make it a internal mandate and have it followed for all the projects that you deploy
Since FluxCD is flexible, you could use that as an advantage and mould it the way you see fit.
1
Categories
- All Categories
- 207 LFX Mentorship
- 207 LFX Mentorship: Linux Kernel
- 734 Linux Foundation IT Professional Programs
- 339 Cloud Engineer IT Professional Program
- 166 Advanced Cloud Engineer IT Professional Program
- 66 DevOps Engineer IT Professional Program
- 132 Cloud Native Developer IT Professional Program
- 122 Express Training Courses
- 122 Express Courses - Discussion Forum
- 5.9K Training Courses
- 40 LFC110 Class Forum - Discontinued
- 66 LFC131 Class Forum
- 39 LFD102 Class Forum
- 222 LFD103 Class Forum
- 17 LFD110 Class Forum
- 34 LFD121 Class Forum
- 17 LFD133 Class Forum
- 6 LFD134 Class Forum
- 17 LFD137 Class Forum
- 70 LFD201 Class Forum
- 3 LFD210 Class Forum
- 2 LFD210-CN Class Forum
- 2 LFD213 Class Forum - Discontinued
- 128 LFD232 Class Forum - Discontinued
- 1 LFD233 Class Forum
- 3 LFD237 Class Forum
- 23 LFD254 Class Forum
- 689 LFD259 Class Forum
- 110 LFD272 Class Forum
- 3 LFD272-JP クラス フォーラム
- 10 LFD273 Class Forum
- 112 LFS101 Class Forum
- LFS111 Class Forum
- 2 LFS112 Class Forum
- 1 LFS116 Class Forum
- 3 LFS118 Class Forum
- 3 LFS142 Class Forum
- 3 LFS144 Class Forum
- 3 LFS145 Class Forum
- 1 LFS146 Class Forum
- 2 LFS147 Class Forum
- 8 LFS151 Class Forum
- 1 LFS157 Class Forum
- 17 LFS158 Class Forum
- 5 LFS162 Class Forum
- 1 LFS166 Class Forum
- 3 LFS167 Class Forum
- 1 LFS170 Class Forum
- 1 LFS171 Class Forum
- 2 LFS178 Class Forum
- 2 LFS180 Class Forum
- 1 LFS182 Class Forum
- 4 LFS183 Class Forum
- 30 LFS200 Class Forum
- 737 LFS201 Class Forum - Discontinued
- 2 LFS201-JP クラス フォーラム
- 17 LFS203 Class Forum
- 118 LFS207 Class Forum
- 1 LFS207-DE-Klassenforum
- LFS207-JP クラス フォーラム
- 301 LFS211 Class Forum
- 55 LFS216 Class Forum
- 50 LFS241 Class Forum
- 44 LFS242 Class Forum
- 37 LFS243 Class Forum
- 13 LFS244 Class Forum
- 1 LFS245 Class Forum
- 45 LFS250 Class Forum
- 1 LFS250-JP クラス フォーラム
- LFS251 Class Forum
- 146 LFS253 Class Forum
- LFS254 Class Forum
- LFS255 Class Forum
- 6 LFS256 Class Forum
- LFS257 Class Forum
- 1.2K LFS258 Class Forum
- 9 LFS258-JP クラス フォーラム
- 116 LFS260 Class Forum
- 156 LFS261 Class Forum
- 41 LFS262 Class Forum
- 82 LFS263 Class Forum - Discontinued
- 15 LFS264 Class Forum - Discontinued
- 11 LFS266 Class Forum - Discontinued
- 23 LFS267 Class Forum
- 18 LFS268 Class Forum
- 29 LFS269 Class Forum
- 200 LFS272 Class Forum
- 1 LFS272-JP クラス フォーラム
- LFS274 Class Forum
- 3 LFS281 Class Forum
- 8 LFW111 Class Forum
- 257 LFW211 Class Forum
- 180 LFW212 Class Forum
- 12 SKF100 Class Forum
- SKF200 Class Forum
- SKF201 Class Forum
- 791 Hardware
- 199 Drivers
- 68 I/O Devices
- 37 Monitors
- 98 Multimedia
- 174 Networking
- 91 Printers & Scanners
- 85 Storage
- 754 Linux Distributions
- 82 Debian
- 67 Fedora
- 16 Linux Mint
- 13 Mageia
- 23 openSUSE
- 147 Red Hat Enterprise
- 31 Slackware
- 13 SUSE Enterprise
- 351 Ubuntu
- 465 Linux System Administration
- 39 Cloud Computing
- 71 Command Line/Scripting
- Github systems admin projects
- 91 Linux Security
- 78 Network Management
- 101 System Management
- 47 Web Management
- 56 Mobile Computing
- 17 Android
- 28 Development
- 1.2K New to Linux
- 1K Getting Started with Linux
- 366 Off Topic
- 114 Introductions
- 171 Small Talk
- 20 Study Material
- 534 Programming and Development
- 293 Kernel Development
- 223 Software Development
- 1.2K Software
- 212 Applications
- 182 Command Line
- 3 Compiling/Installing
- 405 Games
- 312 Installation
- 79 All In Program
- 79 All In Forum
Upcoming Training
-
August 20, 2018
Kubernetes Administration (LFS458)
-
August 20, 2018
Linux System Administration (LFS301)
-
August 27, 2018
Open Source Virtualization (LFS462)
-
August 27, 2018
Linux Kernel Debugging and Security (LFD440)