Merge branch '516-new-job-yarn-lint-job' into 'latest'

# Changelog

All notable changes to this job will be documented in this file.

## [0.1.0] - 2022-02-21

* Initial version

 No newline at end of file

## Objective

This job will run a predefined `lint` script in your `package.json` which will check your code quality.

## How to use it

1. Make sure that your project has 

   [`package.json`](https://docs.npmjs.com/cli/v6/configuring-npm/package-json){:target="_blank"}

   file which contains the required `lint` command in the `scripts` object

2. Copy the job URL located in the `Install` part of the right panel and add it inside the `include` list of your `.gitlab-ci.yml` file (see the [quick setup](/use-the-hub/#quick-setup)). You can specify [a fixed version](/versioning/) instead of `latest`, use the version selector at the top right of the page.

3. If you need to customize the job (stage, variables, ...) 👉 check the [jobs

   customization](/use-the-hub/#jobs-customization)

4. You are done, the job is ready to use ! 😉

## Job details

* Job name: `yarn_lint`

* Default stage: `static_tests`

* Docker image: [`node:17.8.0-buster-slim`](https://hub.docker.com/_/node){:target="_blank"}

* When: `always`

## Variables

!!! note

    All paths defined in variables are relative and start from the root of your

    repository.

| Name | Description | Default |

| ---- | ----------- | ------- |

| `PROJECT_ROOT` | Relative path to the directory containing `package.json` (**see warning below**)  | ` ` |

| `YARN_INSTALL_OPTIONS` | Additional options for `yarn install` | ` ` |

| `YARN_LINT_OPTIONS` | Additional options for `yarn run lint` | ` ` |

!!! warning

    In the case you are updating `PROJECT_ROOT` and you want to have a properly working cache,

    consider making this variable a global variable in the root of your `.gitlab-ci.yml`. Learn how

    easy it is [here](https://docs.gitlab.com/ee/ci/variables/#create-a-custom-cicd-variable-in-the-gitlab-ciyml-file).

### Cache

This job creates a global cache configuration. Regarding the configuration

applied, cache behavior is the following:

* Each branch has its own version

* Cached directory is `$PROJECT_ROOT/node_modules`

* If `package.json` or `yarn.json` is edited, the cache is updated

More information on Gitlab caching mechanism in [Gitlab CI/CD caching

documentation](https://docs.gitlab.com/ee/ci/caching/index.html).

 No newline at end of file

name: yarn_lint

description: A ready-to-use linter, to help validate the quality of your source code. It uses available node_modules if there are any from yarn_install job. 

default_stage: static_tests

icon: 🔍

maintainer: GridexX

license: MIT

images:

  "node": "17.8.0-buster-slim"

tools:

labels:

  - GitLab

  - Linter

  - Quality

  - Yarn

  - Utilities

* Initial version

 No newline at end of file

# Job from R2Devops hub --> r2devops.io

stages: 

- static_tests

cache:

  key:

    files:

      - "${CI_PROJECT_DIR}/${PROJECT_ROOT}/yarn.lock"

      - "${CI_PROJECT_DIR}/${PROJECT_ROOT}/package.json"

    prefix: "yarn-${CI_COMMIT_REF_SLUG}"

  paths:

    - "${CI_PROJECT_DIR}/${PROJECT_ROOT}/node_modules"

yarn_lint:

  stage: static_tests

  image: 

      name: node:17.8.0-buster-slim

      entrypoint: [""]

  variables:

    YARN_INSTALL_OPTIONS: ""

    YARN_LINT_OPTIONS: ""

  script:

    - cd ${CI_PROJECT_DIR}/${PROJECT_ROOT}

    - yarn install ${YARN_INSTALL_OPTIONS}

    - yarn lint ${YARN_LINT_OPTIONS}