---
- job:
    name: "elastic+elasticsearch+pull-request+bwc"
    display-name: "elastic / elasticsearch - pull request bwc"
    description: "Testing of Elasticsearch pull requests - bwc"
    workspace: "/dev/shm/elastic+elasticsearch+pull-request+bwc"
    scm:
      - git:
          refspec: "+refs/pull/${ghprbPullId}/*:refs/remotes/origin/pr/${ghprbPullId}/*"
          branches:
            - "${ghprbActualCommit}"
    triggers:

---
- job:
    name: "elastic+elasticsearch+pull-request+full-bwc"
    display-name: "elastic / elasticsearch - pull request full-bwc"
    description: "Testing of Elasticsearch pull requests - full-bwc"
    project-type: matrix
    node: master
    child-workspace: "/dev/shm/elastic+elasticsearch+pull-request+full-bwc"
    scm:
      - git:
          refspec: "+refs/pull/${ghprbPullId}/*:refs/remotes/origin/pr/${ghprbPullId}/*"
          branches:

---
jjbb-template: generic-gradle-unix.yml
vars:
  - job-name: elastic+elasticsearch+%BRANCH%+intake+multijob+bwc
  - job-display-name: "elastic / elasticsearch # %BRANCH% - intake bwc"
  - job-description: Elasticsearch %BRANCH% branch intake backwards compatibility checks.

---
jjbb-template: matrix-gradle-unix.yml
vars:
  - job-name: elastic+elasticsearch+%BRANCH%+periodic+bwc
  - job-display-name: "elastic / elasticsearch # %BRANCH% - backwards compatibility matrix"
  - job-description: "Testing of the Elasticsearch %BRANCH% branch backwards compatibility matrix.\n"
  - matrix-yaml-file: ".ci/bwcVersions"
  - matrix-variable: BWC_VERSION

    dependsOn tasks.matching { it.name ==~ /v[0-9\.]+#bwcTest/ }
  }
}

tasks.withType(Test).configureEach {
  onlyIf { project.bwc_tests_enabled }
  nonInputProperties.systemProperty 'tests.bwc', 'true'
}

tasks.matching { it.name.equals("check") }.configureEach {dependsOn(bwcTestSnapshots) }

---
jjbb-template: periodic-trigger-lgc.yml
vars:
  - periodic-job: elastic+elasticsearch+%BRANCH%+periodic+bwc
  - lgc-job: elastic+elasticsearch+%BRANCH%+intake

        result.output.contains("distfile /distribution/bwc/bugfix/build/bwc/checkout-7.10/distribution/archives/darwin-tar/" +
                "build/distributions/elasticsearch-7.10.1-SNAPSHOT-darwin-x86_64.tar.gz")
    }

    def "bwc expanded distribution folder can be resolved as bwc project artifact"() {
        setup:
        buildFile << """

        configurations {

        result.task(":setupDistro").outcome == TaskOutcome.SUCCESS
        assertExtractedDistroIsCreated("distribution/bwc/minor/build/install/elastic-distro",
                'bwc-marker.txt')
    }

    def "fails on resolving bwc versions with no bundled jdk"() {
        given:
        internalBuild()
        bwcMinorProjectSetup()
        buildFile << """

import java.util.Arrays;
import java.util.List;
import java.util.Locale;

import static org.elasticsearch.gradle.internal.util.JavaUtil.getJavaHome;

/**
 * By registering bwc tasks via this extension we can support declaring custom bwc tasks from the build script
 * without relying on groovy closures and sharing common logic for tasks created by the BwcSetup plugin already.
 */
public class BwcSetupExtension {

and link:./distribution/bwc/build.gradle[distribution/bwc/build.gradle]
for more information.

When running `./gradlew check`, minimal bwc checks are also run against compatible versions that are not yet released.

==== BWC Testing against a specific remote/branch

Sometimes a backward compatibility change spans two versions. A common case is a new functionality