{"id":26431,"date":"2017-02-28T11:47:35","date_gmt":"2017-02-28T11:47:35","guid":{"rendered":"https:\/\/dev.railscarma.com\/multi-tenancy-using-apartment-gem\/"},"modified":"2024-01-10T12:57:15","modified_gmt":"2024-01-10T12:57:15","slug":"location-multi-avec-appartement-gem","status":"publish","type":"post","link":"https:\/\/www.railscarma.com\/fr\/blog\/articles-techniques\/location-multi-avec-appartement-gem\/","title":{"rendered":"Multilocation en utilisant Apartment Gem"},"content":{"rendered":"
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

Comprenons d'abord la diff\u00e9rence entre une location unique et une location multilocation
\n
\nLocation unique<\/strong>:<\/p>\n

Chaque client poss\u00e8de sa propre instance logicielle, sa propre base de donn\u00e9es et ne sert qu'\u00e0 un seul client. Ici, le logiciel peut \u00eatre personnalis\u00e9 pour r\u00e9pondre aux exigences sp\u00e9cifiques du client car il est ind\u00e9pendant.<\/p>\n


\nLocations multiples:<\/strong><\/p>\n

Dans ce cas, une seule instance d\u2019application logicielle sert plusieurs clients. Ici, nous appelons chaque client comme locataire. Ici, nous pouvons modifier les r\u00e8gles de l'interface utilisateur et les r\u00e8gles m\u00e9tier, mais nous ne pouvons pas modifier le code de l'application puisque la m\u00eame architecture est partag\u00e9e par plusieurs clients. C\u2019est \u00e9conomique puisque les co\u00fbts de d\u00e9veloppement et de maintenance du logiciel sont partag\u00e9s entre les clients. Mais les mises \u00e0 jour ne peuvent \u00eatre effectu\u00e9es que par le fournisseur.<\/p>\n

\"mono-locataire-multilocataire\"<\/a>
\nAvantages : <\/strong>
\n1. Un seul mat\u00e9riel qui g\u00e8re plusieurs clients.
\n2. R\u00e9duction des co\u00fbts. Les co\u00fbts peuvent \u00eatre partag\u00e9s entre tous les clients.
\n3. Facilit\u00e9 d'entretien
\n4. La configuration peut \u00eatre modifi\u00e9e sans toucher \u00e0 la base de code.
\n5. De nouveaux locataires peuvent \u00eatre ajout\u00e9s facilement puisqu'il s'agit d'une architecture partag\u00e9e.<\/p>\n

D\u00e9savantages:<\/strong>
\nLa personnalisation de la base de donn\u00e9es sera difficile \u00e0 g\u00e9rer puisqu'il s'agit d'une base de donn\u00e9es unique partag\u00e9e entre plusieurs clients avec diff\u00e9rents locataires.<\/p>\n

Il existe milia, acts_as_tenant et apartment gem pour g\u00e9rer la multi-location dans l'application Rails.<\/p>\n

Appartement Gemme\u00a0:<\/strong><\/p>\n

Ce joyau adopte une mani\u00e8re diff\u00e9rente de g\u00e9rer la multi-location. Cela fonctionne en cr\u00e9ant une autre base de donn\u00e9es pour chaque locataire. Pour PostgreSql, il cr\u00e9e un autre sch\u00e9ma pour chaque locataire. J'aime cette approche car, dans cette situation, l'information est vraiment d\u00e9sengag\u00e9e. La base de donn\u00e9es n'est pas partag\u00e9e et si vous devez effacer les informations d'un client, tout ce que vous avez \u00e0 faire est simplement de supprimer sa base de donn\u00e9es (ou son mod\u00e8le). Il prend \u00e9galement en charge les ascenseurs et permet le basculement automatique entre les locataires du client et automatise ainsi la logique de commutation.<\/p>\n

Cette gem nous aide \u00e0 g\u00e9rer la multi-location dans une application Rails.<\/p>\n

Ajoutez la ligne ci-dessous \u00e0 votre fichier Gemfile et proc\u00e9dez \u00e0 l'installation du bundle.<\/p>\n

joyau 'appartement'<\/code><\/pre>\n
Pour g\u00e9n\u00e9rer le fichier d'initialisation de l'appartement, ex\u00e9cutez la commande ci-dessous\u00a0:<\/p>\n
bundle exec rails g\u00e9n\u00e8re appartement: installer<\/code><\/pre>\n
config.exclusive_models = %w{ Locataire } <\/code><\/pre>\n
Ici, nous pouvons sp\u00e9cifier les locataires qui ont une port\u00e9e globale, comme le mod\u00e8le d'authentification qui est commun \u00e0 tous les locataires.<\/p>\n
Ici, je vais cr\u00e9er un client avec des sous-domaines, ainsi, chaque fois que le client se connecte \u00e0 l'application, l'appartement r\u00e9cup\u00e8re les sous-domaines et interroge la base de donn\u00e9es en fonction du sous-domaine du locataire.<\/p>\n
rails g scaffold Nom du client\u00a0:\u00a0cha\u00eene domaine_tenant\u00a0:\u00a0cha\u00eene<\/code><\/pre>\n
faire<\/p>\n
base de donn\u00e9es rails: migrer<\/code><\/pre>\n
Nous devons cr\u00e9er le locataire de l'appartement, une fois que nous avons cr\u00e9\u00e9 le client.<\/p>\n
Apartment::Tenant.create('tenant_name') - Pour cr\u00e9er un locataire<\/code><\/pre>\n
Utilisez le rappel after_create dans votre mod\u00e8le pour cr\u00e9er des locataires.<\/p>\n
def create_tenant Apartment::Tenant.create(tenant_domain) fin<\/code><\/pre>\n
Une fois le callback ci-dessus ex\u00e9cut\u00e9, toutes les migrations seront ex\u00e9cut\u00e9es sous ce locataire respectif.<\/p>\n
La commutation des sous-domaines sera g\u00e9r\u00e9e automatiquement lorsque nous demanderons l'application avec des sous-domaines. Ci-dessous se trouve la ligne de configuration pour changer les locataires en fonction du sous-domaine.<\/p>\n
Rails.application.config.middleware.use 'Appartement :: Ascenseurs :: Sous-domaine'<\/code><\/pre>\n
Pour basculer entre les locataires<\/p>\n
Appartement\u00a0::Tenant.switch\u00a0!('tenant_name')<\/code><\/pre>\n
Toutes vos requ\u00eates ActiveRecord seront achemin\u00e9es vers le locataire sp\u00e9cifique lorsque le commutateur est sollicit\u00e9.
\nSwitch sera dans la port\u00e9e racine lorsque vous l'appellerez sans arguments.<\/p>\n
M\u00eame le changement de locataire peut \u00eatre effectu\u00e9 sur la base du premier sous-domaine, mais nous devons d\u00e9finir la configuration dans le fichier d'initialisation. Nous pouvons m\u00eame exclure certains sous-domaines ici, comme le sous-domaine normal.<\/p>\n
config.middleware.use 'Appartement :: Ascenseurs :: FirstSubdomain'<\/code><\/pre>\n
Appartement :: Ascenseurs :: FirstSubdomain.exclusive_subdomains = ['www']<\/code><\/pre>\n
Nous pouvons \u00e9galement interdire aux utilisateurs de cr\u00e9er certains domaines tels que www, admin. Ces domaines ne seront pas disponibles pour les utilisateurs pendant qu'ils sont enregistr\u00e9s.<\/p>\n
Il faut d\u00e9commenter la ligne de configuration ci-dessous dans le fichier d'initialisation de l'appartement.<\/p>\n
Apartment::Elevators::Subdomain.exclusive_subdomains = ["public", "www" et "admin" ]<\/code><\/pre>\n
Nous pouvons \u00e9galement changer, en fonction de l'h\u00f4te complet. Ici, nous devons trouver le nom du locataire correspondant dans le hachage en utilisant la ligne de configuration suivante. Nous devons ajouter la ligne ci-dessous \u00e0 votre application.rb<\/p>\n
config.middleware.use 'Appartement :: Ascenseurs :: HostHash', {'example.com' => 'example_tenant'}<\/code><\/pre>\n
Supprimer les locataires\u00a0:<\/strong><\/p>\n
La commande ci-dessous peut \u00eatre utilis\u00e9e pour supprimer des locataires\u00a0:<\/p>\n
Appartement\u00a0::Tenant.drop('tenant_name')<\/code><\/pre>\n
Veuillez consulter la ressource officielle de Gem pour trouver plus de documentation. <\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Abonnez-vous pour les derni\u00e8res mises \u00e0 jour<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\t\t\t\t\t