Difference between revisions of "Globalyzer CI/CD (Continuous Integration and Continuous Delivery)"
(→Project Definition Format) |
|||
| Line 41: | Line 41: | ||
<?xml version="1.0" encoding="UTF-8" standalone="no"?> |
<?xml version="1.0" encoding="UTF-8" standalone="no"?> |
||
| − | + | <!-- All items are allowed anywhere in the xml as long as the |
|
| − | is preserved --> |
+ | hierarchy is preserved --> |
| − | + | <gzproject> |
|
| − | + | <login> |
|
| + | <server> </server> <!-- must match .globalyzerrc setting --> |
||
| − | <username></username> |
||
| + | <username></username> <!-- must be specified in .globalyzerrc --> |
||
| − | <password></password> |
||
| + | <password></password> <!-- must be specified in .globalyzerrc --> |
||
| − | <server></server> |
||
| + | <!-- if .globalyzerrc is present --> |
||
| − | <use-local-rulesets></use-local-rulesets> <!-- optional. May be 'true' or 'false' --> |
||
| + | <use-local-rulesets></use-local-rulesets> <!-- optional. May be 'true' or 'false' --> |
||
| − | <!-- if true, you need a Globalyzer.license --> |
||
| + | <!-- if true, you need a Globalyzer.license --> |
||
| − | <!-- Optional Parameters --> |
||
| + | <!-- Optional Parameters (Delete this section if not using them) --> |
||
<optional> |
<optional> |
||
| − | < |
+ | <!-- If using, host and port must be filled out --> |
| + | <proxy-user> </proxy-user> |
||
<proxy-password></proxy-password> |
<proxy-password></proxy-password> |
||
| − | <proxy-host></proxy-host> |
+ | <proxy-host> </proxy-host> <!-- required if using proxy --> |
| − | <proxy-port></proxy-port> |
+ | <proxy-port> </proxy-port> <!-- required if using proxy --> |
| − | <optional> |
+ | </optional> |
| − | + | </login> |
|
| + | |||
| − | <project-path></project-path> <!-- May instead be specified from command line --> |
||
| + | <!-- Paths may be absolute, or relative --> |
||
| − | <project-name></project-name> |
||
| − | + | <project-path></project-path> <!-- may be specified via command line --> |
|
| − | + | <project-name></project-name> |
|
| + | |||
| − | <data-dictionary-location></data-dictionary-location> <!-- optional --> |
||
| − | + | <report-path></report-path> <!-- may be specified via command line --> |
|
| − | + | <report-type></report-type> <!-- See 'Report Information' --> |
|
| + | |||
| − | <generate-partial-results></generate-partial-results> <!-- optional. May be 'true' or 'false' --> |
||
| − | + | <data-dictionary-location></data-dictionary-location> <!-- optional --> |
|
| + | <filter-with-dictionary></filter-with-dictionary> <!-- optional. May be 'true' or 'false' --> |
||
| − | <scans> |
||
| + | |||
| + | <scan-timeout>500</scan-timeout> <!-- optional. Max value 600 (seconds) --> |
||
| + | <generate-partial-results></generate-partial-results> <!-- optional. May be 'true' or 'false' --> |
||
| + | <save-history></save-history> <!-- optional. May be 'true' or 'false' --> |
||
| + | |||
| + | |||
| + | <scans> |
||
<scan> |
<scan> |
||
| − | + | <!-- create and execute a single scan with this info --> |
|
| − | <scan-name></scan-name> |
+ | <scan-name> </scan-name> |
| − | <ruleset-name></ruleset-name> |
+ | <ruleset-name> </ruleset-name> <!-- must match existing --> |
| − | <ruleset-owner></ruleset-owner> |
+ | <ruleset-owner></ruleset-owner> |
</scan> |
</scan> |
||
<scan> |
<scan> |
||
| − | + | <!-- create and execute a single scan with this info --> |
|
| − | <scan-name></scan-name> |
+ | <scan-name> </scan-name> |
| − | <ruleset-name></ruleset-name> |
+ | <ruleset-name> </ruleset-name> <!-- must match existing --> |
| − | <ruleset-owner></ruleset-owner> |
+ | <ruleset-owner></ruleset-owner> |
| − | < |
+ | <!-- optional --> |
| − | < |
+ | <use-machine-learning>true</use-machine-learning> <!-- May be 'true' or 'false' --> |
| + | <!-- if true, you must have generated --> |
||
| − | <!-- optional: specify files/directories to scan --> |
||
| + | <!-- machine learning zip files --> |
||
| − | <scan-items> |
||
| + | <!-- from the Workbench --> |
||
| − | <item></item> |
||
| − | + | <!-- optional --> |
|
| − | </scan- |
+ | <encoding>UTF-8</encoding> <!-- encoding of files to scan --> |
| − | + | <!-- optional --> |
|
| + | <scan-items> <!-- may be overridden via command line --> |
||
| − | <comments> |
||
| − | + | <item></item> <!-- delete me if blank --> |
|
| − | < |
+ | <item></item> <!-- delete me if blank --> |
| − | + | </scan-items> |
|
| − | + | <!-- optional --> |
|
| − | + | <comments> |
|
| − | < |
+ | <!-- customize Globalyzer recognized comments --> |
| + | <todo>SPECIAL_GLOBALYZER_TODO_COMMENT</todo> |
||
| − | <!-- optional --> |
||
| + | <ignore-next-line>GBLYZR_IGNORE_NEXT_LINE</ignore-next-line> |
||
| − | <checks> |
||
| + | <start-ignore>GLOBALYZER_START_IGNORE</start-ignore> |
||
| − | <!-- specify which issue types to detect --> |
||
| − | < |
+ | <end-ignore>GBL_END_IGNORE</end-ignore> |
| − | + | </comments> |
|
| − | + | <!-- optional --> |
|
| − | + | <checks> |
|
| − | < |
+ | <!-- specify which issue types to detect --> |
| + | <embedded-strings>true</embedded-strings> |
||
| + | <locale-sensitive-methods>false</locale-sensitive-methods> |
||
| + | <general-patterns>true</general-patterns> |
||
| + | <static-file-references>false</static-file-references> |
||
| + | </checks> |
||
</scan> |
</scan> |
||
| − | + | </scans> |
|
| − | + | </gzproject> |
|
Revision as of 21:54, 12 June 2019
Contents
What is Globalyzer Lite and Globalyzer CI/CD?
Globalyzer Lite is the product that allows users to scan code and create reports without having to use the Globalyzer Workbench or set up a database. In the Lingoport Continuous Globalization Server, Globalyzer Lite (Globalyzer CI/CD) is an integral part of the process to create reports that are displayed in the Lingoport Dashboard showing the number of internationalization issues detected.
Using Globalyzer Lite in a Continuous Globalization System
If the Lingoport Continuous Globalization System was installed and configured using the Stack Installer or Stack Updater, then Globalyzer Lite has already been integrated into the system.
- Check in a project definition file into source control.
- On-board a Jenkins project for the code base using one of the Globalyzer Lite templates like Lingoport.SampleLite or Lingoport.SampleLiteLRM.
- Check the Lingoport Dashboard and verify that the results are shown.
Globalyzer Lite is easy to integrate into other Continuous Integration (CI) systems as well.
- Check in a project definition file into source control (or, if you prefer, place one in the Jenkins server's filesystem).
- Run the following from Jenkins' shell:
java -jar globalyzer-lite.jar -f "${WORKSPACE}/GlobalyzerProjectDefinitionFile.xml" --project-path "${WORKSPACE}" --report-path "globalyzer-lite-reports"
- Use the Lingoport Dashboard to display the results from the generated reports.
You may also pass the reports to your own reporting system.
Using Globalyzer Lite from a command line
Globalyzer Lite can be executed from a command prompt or shell via the following command:
java -jar globalyzer-lite.jar some_location/YourProjectDefinitionFile.xml
After Globalyzer Lite finishes each scan, a relevant Globalyzer report is created at the location specified in the Project Definition's report path.
Lite also allows for altering the following parameters via command line options:
- The Project Path
- The Report Path
- The Files/Directories to scan
- The location of the Globalyzer License (if using Local Rule Sets)
Project Definition Format
Here is the template for a project definition file. For the full instructions to setup a project definition file, see our help page.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<gzproject>
<login>
<server> </server>
<username></username>
<password></password>
<use-local-rulesets></use-local-rulesets>
<optional>
<proxy-user> </proxy-user>
<proxy-password></proxy-password>
<proxy-host> </proxy-host>
<proxy-port> </proxy-port>
</optional>
</login>
<project-path></project-path> <project-name></project-name>
<report-path></report-path> <report-type></report-type>
<data-dictionary-location></data-dictionary-location> <filter-with-dictionary></filter-with-dictionary>
<scan-timeout>500</scan-timeout> <generate-partial-results></generate-partial-results> <save-history></save-history>
<scans>
<scan>
<scan-name> </scan-name>
<ruleset-name> </ruleset-name>
<ruleset-owner></ruleset-owner>
</scan>
<scan>
<scan-name> </scan-name>
<ruleset-name> </ruleset-name>
<ruleset-owner></ruleset-owner>
<use-machine-learning>true</use-machine-learning>
<encoding>UTF-8</encoding>
<scan-items>
<item></item>
<item></item>
</scan-items>
<comments>
<todo>SPECIAL_GLOBALYZER_TODO_COMMENT</todo>
<ignore-next-line>GBLYZR_IGNORE_NEXT_LINE</ignore-next-line>
<start-ignore>GLOBALYZER_START_IGNORE</start-ignore>
<end-ignore>GBL_END_IGNORE</end-ignore>
</comments>
<checks>
<embedded-strings>true</embedded-strings>
<locale-sensitive-methods>false</locale-sensitive-methods>
<general-patterns>true</general-patterns>
<static-file-references>false</static-file-references>
</checks>
</scan>
</scans>
</gzproject>