From d1487419905eb2430688cb1f137c6b88bbaefcbb Mon Sep 17 00:00:00 2001 From: AadarshRajesh <121949882+AadarshRajesh@users.noreply.github.com> Date: Thu, 4 Apr 2024 07:38:16 +0530 Subject: [PATCH 1/7] Update fr-010.installation.md --- .../050.self-hosted/fr-010.installation.md | 458 ++++++++++++++++++ 1 file changed, 458 insertions(+) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index e69de29bb2..2951c68166 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -0,0 +1,458 @@ +*** + +titre : 'Installation' +description: 'Installation simple - prend environ trois minutes !' +balises : \['Open Source'] +mots-clés : \['Installation NocoDB', 'Installation du docker NocoDB', 'Installation NocoDB nodejs', 'Essayage rapide NocoDB', 'Prérequis NocoDB'] +------------------------------------------------------------------------------------------------------------------------------------------------- + +Installation simple – prend environ trois minutes ! + +## Conditions préalables + +* [Docker](https://www.docker.com/get-started) or [Noeud.js](https://nodejs.org/en/download)( > v18.x ) + +## Essai rapide + +### Docker + +If you are a Docker user, you may try this way! + + + + +```bash +docker run -d --name nocodb \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +nocodb/nocodb:latest +``` + + + + +```bash +docker run -d --name nocodb-mysql \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="mysql2://host.docker.internal:3306?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest +``` + + + + +```bash +docker run -d --name nocodb-postgres \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="pg://host.docker.internal:5432?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest +``` + + + + +```bash +docker run -d --name nocodb-mssql \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="mssql://host.docker.internal:1433?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest +``` + + + + +:::tip +To persist data in docker you can mount volume at `/usr/app/data/`depuis la 0.10.6. Dans l'ancienne version, montez sur`/usr/src/app`. Sinon, vos données seront perdues après la recréation du conteneur. +::: + +:::conseil +Si vous envisagez de saisir des caractères spéciaux, vous devrez peut-être modifier vous-même le jeu de caractères et le classement lors de la création de la base de données. Veuillez consulter les exemples pour[Docker MySQL](https://github.com/nocodb/nocodb/issues/1340#issuecomment-1049481043). +::: + +### Docker Compose + +We provide different docker-compose.yml files under [ce répertoire](https://github.com/nocodb/nocodb/tree/master/docker-compose). Voici quelques exemples. + + + + +```bash +git clone https://github.com/nocodb/nocodb +cd nocodb/docker-compose/mysql +docker-compose up -d +``` + + + + +```bash +git clone https://github.com/nocodb/nocodb +cd nocodb/docker-compose/pg +docker-compose up -d +``` + + + + +```bash +git clone https://github.com/nocodb/nocodb +cd nocodb/docker-compose/mssql +docker-compose up -d +``` + + + + +:::tip +To persist data in docker you can mount volume at `/usr/app/data/`depuis la 0.10.6. Dans l'ancienne version, montez sur`/usr/src/app`. +Si vous envisagez de saisir des caractères spéciaux, vous devrez peut-être modifier vous-même le jeu de caractères et le classement lors de la création de la base de données. Veuillez consulter les exemples pour[MySQL Docker Composer](https://github.com/nocodb/nocodb/issues/1313#issuecomment-1046625974). +::: + +### NPX + +Vous pouvez exécuter la commande ci-dessous si vous avez besoin d'une configuration interactive. + +```bash +npx create-nocodb-app +``` + +#### Aperçu: + +image + +### Homebrew + +```bash +brew tap nocodb/nocodb +brew install nocodb +nocodb +``` + +### Exécutables + +Vous pouvez télécharger des exécutables directement et les exécuter sans aucune dépendance supplémentaire. Utilisez la bonne commande en fonction de votre plateforme. + + + + +```bash +curl http://get.nocodb.com/macos-x64 -o nocodb -L \ + && chmod +x nocodb \ + && ./nocodb +``` + + + + +```bash +curl http://get.nocodb.com/macos-arm64 -o nocodb -L \ + && chmod +x nocodb \ + && ./nocodb +``` + + + + +```bash +curl http://get.nocodb.com/linux-x64 -o nocodb -L \ + && chmod +x nocodb \ + && ./nocodb +``` + + + + +```bash +curl http://get.nocodb.com/linux-arm64 -o nocodb -L \ + && chmod +x nocodb \ + && ./nocodb +``` + + + + +```bash +iwr http://get.nocodb.com/win-x64.exe -OutFile "Noco-win-x64.exe" +.\Noco-win-x64.exe +``` + + + + +```bash +iwr http://get.nocodb.com/win-arm64.exe -OutFile "Noco-win-arm64.exe" +.\Noco-win-arm64.exe +``` + + + + +### Application de nœud + +Nous fournissons une application NodeJS simple pour commencer. + +```bash +git clone https://github.com/nocodb/nocodb-seed +cd nocodb-seed +npm install +npm start +``` + +### AWS ECS (Fargate) + +
+ Click to Expand + +#### Créer un cluster ECS + +``` +aws ecs create-cluster \ +--cluster-name +``` + +#### Créer un groupe de journaux + +``` +aws logs create-log-group \ +--log-group-name /ecs// +``` + +#### Créer une définition de tâche ECS + +Chaque fois que vous le créez, une nouvelle version sera ajoutée. Si elle n'existe pas, la version sera 1. + +```bash +aws ecs register-task-definition \ +--cli-input-json "file://./.json" +``` + +:::conseil +Ce fichier json définit la spécification du conteneur. Vous pouvez définir ici des secrets tels que NC\_DB et des variables d'environnement. +::: + +Voici l'exemple de définition de tâche + +```json +{ + "family": "nocodb-sample-task-def", + "networkMode": "awsvpc", + "containerDefinitions": [{ + "name": "", + "image": "nocodb/nocodb:latest", + "essential": true, + "logConfiguration": { + "logDriver": "awslogs", + "options": { + "awslogs-group": "/ecs//", + "awslogs-region": "", + "awslogs-stream-prefix": "ecs" + } + }, + "secrets": [{ + "name": "", + "valueFrom": "" + }], + "environment": [{ + "name": "", + "value": "" + }], + "portMappings": [{ + "containerPort": 8080, + "hostPort": 8080, + "protocol": "tcp" + }] + }], + "requiresCompatibilities": [ + "FARGATE" + ], + "cpu": "256", + "memory": "512", + "executionRoleArn": "", + "taskRoleArn": "" +} +``` + +#### Créer un service ECS + +```bash +aws ecs create-service \ +--cluster \ +--service-name \ +--task-definition : \ +--desired-count \ +--launch-type "FARGATE" \ +--platform-version \ +--health-check-grace-period-seconds \ +--network-configuration "awsvpcConfiguration={subnets=[""], securityGroups=[""], assignPublicIp=ENABLED}" \ +--load-balancer targetGroupArn=,containerName=,containerPort= +``` + +:::conseil + +If your service fails to start, you may check the logs in ECS console or in Cloudwatch. Generally it fails due to the connection between ECS container and NC\_DB. Make sure the security groups have the correct inbound and outbound rules. + +::: + +
+ +### GCP (Cloud Run) + +
+ Click to Expand + +#### Extraire l'image NocoDB sur Cloud Shell + +Étant donné que Cloud Run ne prend en charge que les images de Google Container Registry (GCR) ou d'Artifact Registry, nous devons extraire l'image NocoDB, la marquer et la transférer dans GCP à l'aide de Cloud Shell. Voici quelques exemples de commandes que vous pouvez exécuter dans Cloud Shell. + +```bash +# pull latest NocoDB image +docker pull nocodb/nocodb:latest + +# tag the image +docker tag nocodb/nocodb:latest gcr.io//nocodb/nocodb:latest + +# push the image to GCR +docker push gcr.io//nocodb/nocodb:latest +``` + +#### Déployer NocoDB sur Cloud Run + +```bash +gcloud run deploy --image=gcr.io//nocodb/nocodb:latest \ + --region=us-central1 \ + --allow-unauthenticated \ + --platform=managed +``` + +
+ +### Océan numérique (application) + +
+ Click to Expand + +#### Créer des applications + +Sur la page d'accueil, cliquez sur l'icône Créer et sélectionnez des applications (déployez votre code). + +![Screenshot 2022-02-19 at 12 17 43 PM](https://user-images.githubusercontent.com/86527202/154790558-f8fe5580-5a58-412c-9c2e-145587712bf2.png) + +#### Choose Source: Docker Hub + +![Screenshot 2022-02-19 at 12 22 01 PM](https://user-images.githubusercontent.com/86527202/154790563-b5b6d5b4-0bdc-4718-8cea-0a7ee52f283b.png) + +#### Choisissez la source : référentiel + +Configurer le référentiel source comme`nocodb/nocodb`. Vous pouvez éventuellement choisir une balise de version si vous êtes intéressé par une version spécifique de NocoDB. + +![Screenshot 2022-02-19 at 12 23 11 PM](https://user-images.githubusercontent.com/86527202/154790564-1dcb5e33-3a57-471a-a44c-835a410a0cb7.png) + +#### \[Facultatif] Configurations supplémentaires + +![Screenshot 2022-02-19 at 12 24 44 PM](https://user-images.githubusercontent.com/86527202/154790565-c0234b2e-ad50-4042-90b6-4f8798f1d585.png) + +#### Nommez votre service Web + +Choisissez un nom pour votre application NocoDB. Ce nom fera ultérieurement partie de l'URL +Choisissez la région la plus proche pour l'hébergement cloud![Screenshot 2022-02-19 at 12 28 11 PM](https://user-images.githubusercontent.com/86527202/154790567-a6e65e4e-9aa0-4edb-998e-da8803ad6e23.png) + +#### Finaliser et lancer + +* Sélectionnez le plan d'hébergement pour votre application NocoDB + +* Cliquez sur "Lancer l'application" + +![Screenshot 2022-02-19 at 12 29 23 PM](https://user-images.githubusercontent.com/86527202/154790570-62044713-5cca-4d06-82ec-f3cc257218a1.png) + +L'application sera créée et l'URL sera disponible dans une minute ! L'URL ressemblera à quelque chose comme https://simply-nocodb-rsyir.ondigitalocean.app/ + +
+ +### Cloudron + +
+ Click to Expand + +#### Accédez à l'App Store + +Connectez-vous à Cloudron et sélectionnez App Store + +![image](https://user-images.githubusercontent.com/35857179/194700146-aae90503-a8fd-4bc5-8397-39f0bc279606.png) + +#### Rechercher NocoDB + +![image](https://user-images.githubusercontent.com/35857179/194700181-b5303919-70b8-4cf8-bebe-7e75aca601f3.png) + +#### Cliquez sur Installer + +![image](https://user-images.githubusercontent.com/35857179/194700192-d702f5c2-2afa-45c5-9823-4ebe9e141b01.png) + +#### Configurer NocoDB + +![image](https://user-images.githubusercontent.com/35857179/194700230-c35e934f-bd93-4948-8f31-935483b30571.png) + +#### Accédez à Mon application et lancez NocoDB + +![image](https://user-images.githubusercontent.com/35857179/194700464-50098cb1-bf94-42bb-a63a-cc0aad671913.png) + +
+ +### CapRover + +
+ Click to Expand + +#### Connectez-vous et cliquez sur Applications/bases de données en un seul clic + +![image](https://user-images.githubusercontent.com/35857179/194701420-7fe5c396-a488-456c-98de-6f2ee1151fc5.png) + +#### Rechercher NocoDB + +![image](https://user-images.githubusercontent.com/35857179/194701537-63e7efc5-013b-4ca9-8659-56e9d536e7d0.png) + +#### Configurer NocoDB et déployer + +![image](https://user-images.githubusercontent.com/35857179/194701576-19519df5-2aa4-435d-8fc6-7bc684b9cfe1.png) + +
+ +### Chemin de fer + +
+ Click to Expand + +#### Accédez aux modèles + +Aller à[Modèles](https://railway.app/templates), Recherchez NocoDB et cliquez sur Déployer + +![image](https://user-images.githubusercontent.com/35857179/194702833-1bea22ee-6dfa-4024-ac27-e33fe56e5500.png) + +#### Configurer NocoDB et déployer + +![image](https://user-images.githubusercontent.com/35857179/194702960-149393fe-b00f-4d84-9e54-22cb7616ba44.png) + +
+ +### Prison de Fribussed / Freenas / Truens + +Voir[ici](https://gist.github.com/Zamana/e9281d736f9e9ce5882c6f4b140a590e)fourni par[C.R. Zamana](https://github.com/Zamana). + +## Exemples de démos + +### Codesandbox + + + +### Déploiement de Docker avec une seule commande + + + +### Utiliser NPX + + From d464c0666a6ccb27223cbe569fa51796ec67fb9a Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:00 +0530 Subject: [PATCH 2/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index 2951c68166..d52e8023d0 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -16,7 +16,7 @@ Installation simple – prend environ trois minutes ! ### Docker -If you are a Docker user, you may try this way! +Si vous utilisez Docker, vous pouvez essayer de cette manière ! From 39128cafe8b61d56c7e16b529e1bf103dfd28fa9 Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:09 +0530 Subject: [PATCH 3/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index d52e8023d0..b249995560 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -72,7 +72,7 @@ To persist data in docker you can mount volume at `/usr/app/data/`depuis la 0.10 ::: :::conseil -Si vous envisagez de saisir des caractères spéciaux, vous devrez peut-être modifier vous-même le jeu de caractères et le classement lors de la création de la base de données. Veuillez consulter les exemples pour[Docker MySQL](https://github.com/nocodb/nocodb/issues/1340#issuecomment-1049481043). +Si vous envisagez d'utiliser des caractères spéciaux, vous devrez peut-être ajuster vous-même le jeu de caractères et le classement lors de la création de la base de données. Veuillez consulter les exemples pour [Docker MySQL](https://github.com/nocodb/nocodb/issues/1340#issuecomment-1049481043). ::: ### Docker Compose From 7f877aa1533309244b4fb016f2a4aa535405105c Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:18 +0530 Subject: [PATCH 4/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index b249995560..f1853e07fb 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -295,7 +295,7 @@ aws ecs create-service \ :::conseil -If your service fails to start, you may check the logs in ECS console or in Cloudwatch. Generally it fails due to the connection between ECS container and NC\_DB. Make sure the security groups have the correct inbound and outbound rules. +Si votre service ne démarre pas, vous pouvez vérifier les journaux dans la console ECS ou dans Cloudwatch. Généralement, cela échoue en raison de la connexion entre le conteneur ECS et NC_DB. Assurez-vous que les groupes de sécurité ont les règles entrantes et sortantes correctes. ::: From c5cb6d45d408a81a29ddd797e14f1a334c40c268 Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:26 +0530 Subject: [PATCH 5/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index f1853e07fb..0f938d0912 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -233,7 +233,7 @@ aws ecs register-task-definition \ ``` :::conseil -Ce fichier json définit la spécification du conteneur. Vous pouvez définir ici des secrets tels que NC\_DB et des variables d'environnement. +Ce fichier JSON définit la spécification du conteneur. Vous pouvez y définir des secrets tels que NC_DB et des variables d'environnement. ::: Voici l'exemple de définition de tâche From b02dfabbaf9f6b0f0b58266fb3e9aa4d6345f957 Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:33 +0530 Subject: [PATCH 6/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index 0f938d0912..78761a5945 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -10,7 +10,7 @@ Installation simple – prend environ trois minutes ! ## Conditions préalables -* [Docker](https://www.docker.com/get-started) or [Noeud.js](https://nodejs.org/en/download)( > v18.x ) +* [Docker](https://www.docker.com/get-started) or [Node.js](https://nodejs.org/en/download)( > v18.x ) ## Essai rapide From f683f0b636be69272a86c7467caaa8d6a3df88f4 Mon Sep 17 00:00:00 2001 From: Anbarasu Date: Mon, 8 Apr 2024 18:27:42 +0530 Subject: [PATCH 7/7] Update scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- .../020.getting-started/050.self-hosted/fr-010.installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md index 78761a5945..9e91e1e622 100644 --- a/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md +++ b/scripts/docs/fr/020.getting-started/050.self-hosted/fr-010.installation.md @@ -68,7 +68,7 @@ nocodb/nocodb:latest :::tip -To persist data in docker you can mount volume at `/usr/app/data/`depuis la 0.10.6. Dans l'ancienne version, montez sur`/usr/src/app`. Sinon, vos données seront perdues après la recréation du conteneur. +Pour persister les données dans Docker, vous pouvez monter un volume sur `/usr/app/data/` depuis la version 0.10.6. Dans les versions antérieures, montez-le sur `/usr/src/app`. Sinon, vos données seront perdues après la recréation du conteneur. ::: :::conseil