Code source wiki de Serveur de documents Amazon S3
Modifié par jhurst le 2024/04/02 14:25
Afficher les derniers auteurs
author | version | line-number | content |
---|---|---|---|
1 | {{ddtoc/}} | ||
2 | |||
3 | ---- | ||
4 | |||
5 | = Prérequis = | ||
6 | |||
7 | * Un compte Amazon Web Services (AWS) avec la création d’utilisateur via l’interface console disponible à cette adresse :((( | ||
8 | console.aws.amazon.com | ||
9 | |||
10 | Laissez-vous guider par le service IAM (Identity Access Management) pour créer et gérer vos utilisateurs (**Services** > **Security, Identity & Compliance** > **IAM**). | ||
11 | ))) | ||
12 | |||
13 | (% style="text-align:center" %) | ||
14 | [[image:amazonS3_fr_html_270afb69f10317bf.png||height="371" width="526"]] | ||
15 | |||
16 | (% style="text-align: center;" %) | ||
17 | //__Capture : Le service web IAM de Amazon S3 permet de gérer les utilisateurs__// | ||
18 | |||
19 | * À la création des utilisateurs, veillez à noter les couples (ID de clé d’accès, clé d’accès secrète) de chaque utilisateur pour pouvoir les fournir au client Amazon S3 de Digdash. | ||
20 | * Créez sur Amazon S3 un compartiment (ou bucket) à nom universellement unique. | ||
21 | |||
22 | (% class="box infomessage" %) | ||
23 | ((( | ||
24 | Amazon S3 est un service de stockage dans le cloud pour Internet. Pour charger vos données, vous devez d'abord créer un compartiment dans l'une des régions AWS. Vous pouvez ensuite charger un nombre illimité d'objets vers ce compartiment. | ||
25 | ))) | ||
26 | |||
27 | = Création d’un nouveau serveur de documents Amazon S3 = | ||
28 | |||
29 | Vous pouvez récupérer des fichiers stockés sur un compte Amazon S3 : | ||
30 | |||
31 | * Via le Studio | ||
32 | |||
33 | Pour créer un nouveau serveur de documents Amazon S3 dans le Studio : | ||
34 | |||
35 | Ouvrir le Studio > Menu **Outils** > **Gestionnaire des serveurs de documents… Ctrl+U **>** Nouveau** | ||
36 | |||
37 | (% style="text-align:center" %) | ||
38 | [[image:amazonS3_fr_html_f2443f74ab7ce8f1.gif||height="150" width="488"]] | ||
39 | |||
40 | |||
41 | (% style="text-align:center" %) | ||
42 | [[image:amazonS3_fr_html_24c0b9ada443daae.gif||height="131" width="501"]] | ||
43 | |||
44 | (% style="text-align: center;" %) | ||
45 | //__Capture : Création d’un nouveau serveur de documents Amazon S3__// | ||
46 | |||
47 | * Via le navigateur{{comment}}Captures à mettre à jour pour la version 2020R2{{/comment}} | ||
48 | |||
49 | (% style="text-align:center" %) | ||
50 | [[image:amazonS3_fr_html_d057beaef5d1f988.png||height="253" width="472"]] | ||
51 | |||
52 | |||
53 | (% style="text-align:center" %) | ||
54 | [[image:amazonS3_fr_html_50b6c75132116e78.png||height="291" width="486"]] | ||
55 | |||
56 | (% style="text-align: center;" %) | ||
57 | //__Capture : Accès au gestionnaire de documents via le navigateur__// | ||
58 | |||
59 | = Configuration serveur = | ||
60 | |||
61 | * Via le Studio | ||
62 | |||
63 | (% style="text-align:center" %) | ||
64 | [[image:amazonS3_fr_html_413b369ea659871a.png||height="278" width="397"]] | ||
65 | |||
66 | (% style="text-align: center;" %) | ||
67 | //__Capture écran : Configuration serveur pour Amazon S3 via le Studio__// | ||
68 | |||
69 | |||
70 | * Via le navigateur | ||
71 | |||
72 | (% style="text-align:center" %) | ||
73 | [[image:amazonS3_fr_html_5241f5cf7fc86669.png||height="219" width="354"]] | ||
74 | |||
75 | (% style="text-align: center;" %) | ||
76 | //__Capture écran : Configuration serveur pour Amazon S3 via le navigateur__// | ||
77 | |||
78 | == Nom du serveur == | ||
79 | |||
80 | Donnez un nom à votre nouveau serveur de documents Amazon S3. | ||
81 | |||
82 | == URL == | ||
83 | |||
84 | Aucune URL n’est nécessaire pour la création d’un serveur de documents Amazon S3. | ||
85 | |||
86 | == Chemin des documents de l’utilisateur == | ||
87 | |||
88 | Le chemin des documents de l’utilisateur doit __obligatoirement et impérativement__ débuter par le nom du compartiment existant que vous voulez explorer, suivi du chemin du répertoire de vos documents. | ||
89 | |||
90 | En outre, il permet de vérifier si l’accès à votre compte est valide. | ||
91 | |||
92 | (% class="box" %) | ||
93 | ((( | ||
94 | Exemple : Soit le nom du compartiment existant suivant : « dd-com-test-bucket » | ||
95 | ))) | ||
96 | |||
97 | Alors un chemin de documents valide peut être | ||
98 | |||
99 | (% class="box" %) | ||
100 | ((( | ||
101 | **dd-com-test-bucket/directory1/directory2/directory3/** | ||
102 | ))) | ||
103 | |||
104 | == Exploration des sous-dossiers == | ||
105 | |||
106 | Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents. | ||
107 | |||
108 | Par défaut, la recherche de document s’effectue de manière récursive et va explorer tous les sous-dossiers. | ||
109 | |||
110 | |Champs|//Explorer les sous-dossiers//|(% colspan="2" %)//Niveau des sous-dossiers// | ||
111 | |(% rowspan="2" %)Valeurs|Activé|((( | ||
112 | Vide | ||
113 | |||
114 | Valeur par défaut, l’exploration s’opère récursivement dans tous les sous-dossiers | ||
115 | )))|((( | ||
116 | N > 0 | ||
117 | |||
118 | L’exploration s’effectuera dans les N sous-dossier | ||
119 | ))) | ||
120 | |Désactivé|(% colspan="2" %)((( | ||
121 | 0 | ||
122 | |||
123 | Pas d’exploration dans les sous-dossiers, seulement dans le répertoire courant | ||
124 | ))) | ||
125 | |||
126 | __Tableau pour l’exploration des documents pour le connecteur Alfresco__ | ||
127 | |||
128 | == Lecture seule == | ||
129 | |||
130 | Seule la lecture est possible si cette option est activée. | ||
131 | |||
132 | == ID de la clé d’accès == | ||
133 | |||
134 | Entrez dans ce champ l’ID de la clé d’accès (Access key ID) fournie lors de la création de votre utilisateur. | ||
135 | |||
136 | == Clé d’accès secrète == | ||
137 | |||
138 | Entrez dans ce champ la clé d’accès secrète (Secret access key) fournie lors de la création de votre utilisateur. | ||
139 | |||
140 | = Actions possibles = | ||
141 | |||
142 | Via la version web du gestionnaire des serveurs de documents, vous avez la possibilité d’agir sur les fichiers sur le compte Amazon S3. | ||
143 | |||
144 | == Téléchargement == | ||
145 | |||
146 | (% style="text-align:center" %) | ||
147 | [[image:amazonS3_fr_html_c6d546634c64cb3.gif||height="226" width="415"]] | ||
148 | |||
149 | (% style="text-align: center;" %) | ||
150 | //__Capture : Icône de téléchargement__// | ||
151 | |||
152 | C’est une action de base. Chaque utilisateur connecté est autorisé au minimum au droit de lecture. | ||
153 | |||
154 | Le téléchargement est possible via l’icône [[image:amazonS3_fr_html_fb114753cc5d7478.png]] . | ||
155 | |||
156 | == Dépôt de documents == | ||
157 | |||
158 | (% style="text-align:center" %) | ||
159 | [[image:amazonS3_fr_html_a111a5769d268daf.png||height="292" width="643"]] | ||
160 | |||
161 | (% style="text-align: center;" %) | ||
162 | //__Capture : Dépôt de document dans le serveur de documents Google Drive__// | ||
163 | |||
164 | |||
165 | (% class="box infomessage" %) | ||
166 | ((( | ||
167 | **NB** : Il est vivement conseillé de déposer des documents avec une extension explicite. | ||
168 | ))) | ||
169 | |||
170 | Trois options sont disponibles : | ||
171 | |||
172 | * **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.** **La boîte **Ouvrir **s'affiche | ||
173 | * **Entrer une URL** : Entrez l'URL de votre document. Si la case **Ajouter uniquement le lien URL au serveur de documents **est décochée, le contenu pointé par l'URL est téléchargé une seule fois vers le serveur de documents. Si la case **Ajouter uniquement le lien URL au serveur de documents **est cochée, le contenu pointé par l'URL est téléchargé par le serveur à chaque fois qu'il en a besoin (pour une source de données ou sur demande d'un utilisateur). Dans ce dernier cas, l'URL doit être accessible par le serveur. Vous pouvez aussi insérer des variables utilisateur dans l'URL (${user.uid}... voir documentation). Vous pouvez utiliser une URL "file:~/~/", mais dans ce cas le mode **Ajouter uniquement le lien URL au serveur de documents **est forcé. L'URL "file:~/~/" doit être un fichier sur un disque du serveur. Le nom du lien doit se terminer par l'extension propre au type de fichier ajouté (.csv, .html...). | ||
174 | * **Créez un nouveau lien **: Créez un nouveau lien vers un document sur le serveur : Le fichier pointé est le dernier document (dans l'ordre alphabétique) correspondant au lien. Par exemple, un lien « document*.csv » pointera vers le dernier fichier CSV commençant par « document ». | ||
175 | |||
176 | == Édition de documents == | ||
177 | |||
178 | (% style="text-align:center" %) | ||
179 | [[image:amazonS3_fr_html_7cee0d335d98ae28.gif]] | ||
180 | |||
181 | (% style="text-align: center;" %) | ||
182 | //__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__// | ||
183 | |||
184 | L’action est possible via l’icône [[image:amazonS3_fr_html_5bf0156c61aee07c.png]] . | ||
185 | |||
186 | Il peut s’agir des actions suivantes. | ||
187 | |||
188 | === Mise à jour du contenu === | ||
189 | |||
190 | Vous avez la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis votre système. | ||
191 | |||
192 | (% class="box warningmessage" %) | ||
193 | ((( | ||
194 | Avec seule cette action, le nom du document sur lequel l’opération s’effectue gardera son nom. | ||
195 | ))) | ||
196 | |||
197 | === Renommage === | ||
198 | |||
199 | Vous avez la possibilité de renommer un document. Vous préciserez dans le champ prévu à cet effet le nouveau nom à donner au document sans extension. | ||
200 | |||
201 | == Suppression == | ||
202 | |||
203 | Vous avez la possibilité de supprimer un (ou des) document(s) existant(s) dans le Google Drive du compte de service. | ||
204 | |||
205 | Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux checkbox. | ||
206 | |||
207 | L’action est possible via l’icône [[image:amazonS3_fr_html_3f54b9224a4c4ef3.png]] . | ||
208 | |||
209 |