Add Secure Bwc documentation to TESTING.md

[stephen-crawford]

Description

Add Secure BWC documentation to TESTING.md as a followup to #8900.

Related Issues

Resolves #[Issue number to be closed when this PR is merged]

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff
• Commit changes are listed out in CHANGELOG.md file (See: Changelog)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.index.translog.RemoteFSTranslogTests.testSimpleOperationsUpload

• URL: https://build.ci.opensearch.org/job/gradle-check/22976/
• CommitID: fe5a1ab
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[codecov]

Codecov Report

Merging #9414 (4f197b6) into main (8cfde6c) will increase coverage by 0.07%.
The diff coverage is n/a.

❗ Current head 4f197b6 differs from pull request most recent head 6fd0a72. Consider uploading reports for the commit 6fd0a72 to get more accurate results

@@             Coverage Diff              @@
##               main    #9414      +/-   ##
============================================
+ Coverage     71.08%   71.16%   +0.07%     
- Complexity    57428    57534     +106     
============================================
  Files          4781     4781              
  Lines        271184   271184              
  Branches      39591    39591              
============================================
+ Hits         192780   192994     +214     
+ Misses        62122    61934     -188     
+ Partials      16282    16256      -26     

see 468 files with indirect coverage changes

[stephen-crawford]

@dblock here is the documentation you requested. Failures are unrelated. Let me know if you need anything else.

[dbwiddis]

LGTM. I'm curious if we could improve this to be copy-pasteable by setting an environemnt variable for <TARGET_VERSION> and using it.

[stephen-crawford]

Hi @dbwiddis, that is a good idea. I am not sure how we would want to go about referencing the target version to convert from however. We could always assume that the current version is the "new" version, but I don't know what we would want to do for the version we are converting from.

[kotwanikunal]

Compatibility again. Restarting :)

[opensearch-trigger-bot]

Compatibility status:

Checks if related components are compatible with change 6a5b464

Incompatible components

Incompatible components: [https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/security-analytics.git]

Skipped components

Compatible components

Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/cross-cluster-replication.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/performance-analyzer.git, https://github.com/opensearch-project/neural-search.git, https://github.com/opensearch-project/performance-analyzer-rca.git, https://github.com/opensearch-project/opensearch-oci-object-storage.git]

[stephen-crawford]

Can we merge this?

[dblock]

I have some nits. TOC is a must have, SORRY

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/23548/
• CommitID: 861aa2e
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/23546/
• CommitID: c429665
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Compatibility status:

Checks if related components are compatible with change 4f197b6

Incompatible components

Incompatible components: [https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/cross-cluster-replication.git]

Skipped components

Compatible components

Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/performance-analyzer.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/performance-analyzer-rca.git, https://github.com/opensearch-project/neural-search.git, https://github.com/opensearch-project/security-analytics.git, https://github.com/opensearch-project/opensearch-oci-object-storage.git]

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/23549/
• CommitID: 4f197b6

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/23547/
• CommitID: cf7ab7f

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/23550/
• CommitID: 6fd0a72
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[stephen-crawford]

Flaky tests:

[org.opensearch.repositories.azure.AzureBlobContainerRetriesTests.testWriteLargeBlob](https://build.ci.opensearch.org/job/gradle-check/23550/testReport/junit/org.opensearch.repositories.azure/AzureBlobContainerRetriesTests/testWriteLargeBlob/)
    [org.opensearch.action.admin.indices.create.CreateIndexIT.testCreateAndDeleteIndexConcurrently](https://build.ci.opensearch.org/job/gradle-check/23550/testReport/junit/org.opensearch.action.admin.indices.create/CreateIndexIT/testCreateAndDeleteIndexConcurrently/)
    [org.opensearch.action.admin.indices.create.CreateIndexIT.classMethod](https://build.ci.opensearch.org/job/gradle-check/23550/testReport/junit/org.opensearch.action.admin.indices.create/CreateIndexIT/classMethod/)
    [org.opensearch.remotestore.RemoteIndexRecoveryIT.testRerouteRecovery](https://build.ci.opensearch.org/job/gradle-check/23550/testReport/junit/org.opensearch.remotestore/RemoteIndexRecoveryIT/testRerouteRecovery/)
    ```