[docs] Add url secret-source docs

[vortegatorres]

What?

Docs for the new url secret-source implemented here: grafana/k6#5413

Checklist

• I have used a meaningful title for the PR.
• I have described the changes I've made in the "What?" section above.
• I have performed a self-review of my changes.
• I have run the npm start command locally and verified that the changes look good.

• I have made my changes in the docs/sources/k6/next folder of the documentation.
• I have reflected my changes in the docs/sources/k6/v{most_recent_release} folder of the documentation.
• I have reflected my changes in the relevant folders of the two previous k6 versions of the documentation (if still applicable to previous versions).

• I have made my changes in the docs/sources/k6/next folder of the documentation.

Related PR(s)/Issue(s)

grafana/k6#5412

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[Copilot]

Pull request overview

This PR adds comprehensive documentation for the new URL secret source feature in k6, which allows fetching secrets from HTTP endpoints. The documentation provides detailed configuration options, usage examples, and explains features like rate limiting and retry behavior.

Key Changes

• Added complete documentation for URL secret source with configuration methods (CLI, file-based, environment variables)
• Documented HTTP request features including custom headers, response path extraction, rate limiting, and automatic retries
• Provided multiple practical examples for common use cases
• Updated the secret source index to include the new URL source

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
docs/sources/k6/next/using-k6/secret-source/url.md	New comprehensive documentation file for URL secret source feature with configuration options, examples, and usage patterns
docs/sources/k6/next/using-k6/secret-source/_index.md	Added URL secret source to the list of available built-in secret sources

[github-actions]

💻 Deploy preview deleted ([docs] Add url secret-source docs).

[oleiade]

Hey @vortegatorres 👋🏻

It looks like you made your changes in a new v1.5.x folder.

However, the practice we're following is instead to make the changes in next, and backport the changes where relevant for previous releases documentation, as per the Pull Request template: https://github.com/grafana/k6-docs/blob/main/.github/pull_request_template.md?plain=1#L20.

Prior to release, the k6 team hand-in-hand with @heitortsergent will create the v1.5.x folder, once all the changes are documented.

Do you mind adapting the PR accordingly? 🙇🏻

[vortegatorres]

Hey @vortegatorres 👋🏻

It looks like you made your changes in a new v1.5.x folder.

However, the practice we're following is instead to make the changes in next, and backport the changes where relevant for previous releases documentation, as per the Pull Request template: https://github.com/grafana/k6-docs/blob/main/.github/pull_request_template.md?plain=1#L20.

Prior to release, the k6 team hand-in-hand with @heitortsergent will create the v1.5.x folder, once all the changes are documented.

Do you mind adapting the PR accordingly? 🙇🏻

@oleiade I updated the branch accordingly, thanks!

[heitortsergent]

Thanks for opening the PR @vortegatorres! I left a few comments with some edits to make it fit our style guide.

[heitortsergent]

Is duration a type, or should we switch this to string? 🤔

[vortegatorres]

It is a type in Go, that is a string, but should contain a duration. I am not sure if I should use a string here.

[heitortsergent]

Oh, I see! Since these variables are being used in JS/TS, I think we should use string. What do you think? 🤔

[vortegatorres]

Thanks, updated in e7abc20

[heitortsergent]

LGTM, thanks for making all the changes! 🙇