Difference between revisions of "Prepping a Kit"

From Lingoport Wiki
Jump to: navigation, search
(From Source to LRM_DATA prep kit)
(Sending the Files under staging)
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==<group_name>.<project_name>-PrepKit ==
 
When prepping a kit, i.e. collecting the right files, checking for correctness, sending them to the appropriate location, and notifying the recipients, files move to different locations to ensure they are delivered properly or they can be delivered properly later if some malfunction happened, for instance due to a network outage.
 
   
  +
The '''<group_name>.<project_name>-PrepKit''' 'build' Jenkins job preps a kit. It collects the right files, checking for correctness and sends them to the appropriate location, finally notifying the recipients. During this process files move to different system locations to ensure they are delivered properly or they can be delivered properly later if some malfunction happened, for instance due to a network outage.
This section describes how the files are moved
 
   
  +
This section describes how the files are moved.
=== From Source to LRM_DATA prep kit ===
 
==== Getting the Prep Kit under core LRM data ====
 
The first step is to collect the files from the source directly, after a clean checkout/clone from the repository. If all is copacetic, the files to be send for translation are moved under the core LRM data directory, LRM_DATA_HOME, which is typically set to ~/Lingoport_Data/LRM.
 
   
  +
== From Source to core LRM data ==
For instance, if this is the second prep kit, the base files would be moved under:
 
  +
The first step is to collect the files from the source directly, after a clean checkout/clone from the repository. If all is copacetic, the files to be sent for translation are moved under the core LRM data directory, LRM_DATA_HOME, which is typically set to '''<HOME>/Lingoport_Data/LRM'''.
  +
  +
For instance, if this is the ''second'' prep kit, the base files would be moved under:
   
 
<pre>
 
<pre>
<group_name>
+
<HOME>/Lingoport_Data/LRM/<group_name>
 
├── logs
 
├── logs
 
├── prep_kit
 
├── prep_kit
│   └── <project>
+
│   └── <project_name>
 
│   └── PREP_KIT_2
 
│   └── PREP_KIT_2
 
</pre>
 
</pre>
   
==== Moving the Prep Kit under staging ====
+
== Moving the Prep Kit under staging ==
If that stage is successful, the files are then getting ready to be sent and are placed under the <code>sendkits/lingotek</code> or <code>sendkits/ftp</code> depending on the project configuration:
+
If that stage is successful, the files are then getting ready to be sent and are placed under the '''sendkits/lingotek''' or '''sendkits/ftp''' depending on the project configuration:
 
<pre>
 
<pre>
staging
+
<HOME>/Lingoport_Data/LRM/staging
 
├── ...
 
├── ...
 
├── sendkits
 
├── sendkits
Line 36: Line 35:
 
│   └── IncompletePrepKit.xml
 
│   └── IncompletePrepKit.xml
 
</pre>
 
</pre>
  +
  +
== Sending the Files under staging ==
  +
If this has been successful, the next step is to send the files to Lingotek or FTP, depending on the configuration. This may fail due to network problems, server saturation, or other causes. Until the files have successfully been sent, they are kept under '''staging'''.
  +
  +
<b>If the files were not sent, the Jenkins job <code>check_send</code> will later on pick up here in the process</b>
  +
  +
== Keeping Track under L10nStreamlining ==
  +
L10nStreamlining helps keep track of what was sent and received. The last stage of the Prep Kit process is to move the files which were under
  +
* <code>~/Lingoport_Data/LRM/staging/sendkits</code>
  +
over to
  +
* <code>~/Lingoport_Data/L10nStreamlining/<group_name>/projects<project_name>/prepkits/PREP_KIT_2</code>.

Latest revision as of 20:54, 30 January 2017

The <group_name>.<project_name>-PrepKit 'build' Jenkins job preps a kit. It collects the right files, checking for correctness and sends them to the appropriate location, finally notifying the recipients. During this process files move to different system locations to ensure they are delivered properly or they can be delivered properly later if some malfunction happened, for instance due to a network outage.

This section describes how the files are moved.

From Source to core LRM data

The first step is to collect the files from the source directly, after a clean checkout/clone from the repository. If all is copacetic, the files to be sent for translation are moved under the core LRM data directory, LRM_DATA_HOME, which is typically set to <HOME>/Lingoport_Data/LRM.

For instance, if this is the second prep kit, the base files would be moved under:

<HOME>/Lingoport_Data/LRM/<group_name>
├── logs
├── prep_kit
│   └── <project_name>
│       └── PREP_KIT_2

Moving the Prep Kit under staging

If that stage is successful, the files are then getting ready to be sent and are placed under the sendkits/lingotek or sendkits/ftp depending on the project configuration:

<HOME>/Lingoport_Data/LRM/staging
├── ...
├── sendkits
│   └── lingotek
│       ├── <group_name>
│       │   └── <project_name>
│               └── PREP_KIT_2
│                   ├── BaseFileSearch_fr.xml
│                   ├── FilesToPrep.xml
│                   ├── fr
│                   │   ├── file1_en.properties
│                   │   └── file2_en.properties
│                   ├── <project_name>_1_fr.xml
│                   └── IncompletePrepKit.xml

Sending the Files under staging

If this has been successful, the next step is to send the files to Lingotek or FTP, depending on the configuration. This may fail due to network problems, server saturation, or other causes. Until the files have successfully been sent, they are kept under staging.

If the files were not sent, the Jenkins job check_send will later on pick up here in the process

Keeping Track under L10nStreamlining

L10nStreamlining helps keep track of what was sent and received. The last stage of the Prep Kit process is to move the files which were under

  • ~/Lingoport_Data/LRM/staging/sendkits

over to

  • ~/Lingoport_Data/L10nStreamlining/<group_name>/projects<project_name>/prepkits/PREP_KIT_2.