document where to save cloud config files

[mdavis-xyz]

SUMMARY

This fixes part of #79411.
This fixes the comment part.
And the part about the optional security_token field.
This does not modify the error message returned by ansible-test.

This should help with: ansible-collections/amazon.aws#924

ISSUE TYPE

• Docs Pull Request

COMPONENT NAME

config

ADDITIONAL INFORMATION

I don't know what most of those files I modified are. I've only tested AWS stuff previously. So I need someone to confirm that the changes to those other files are applicable to those.

I did not modify the cloudscale one, because that's very barebones. I don't know if it's the same situation as the others.

I did not modify the openshift one, because it already had some mention of putting another file next to this one. That sounds possibly not right. Should both files go into tests/integration instead?

[mattclay]

All of the cloud- prefixed templates are handled the same way, so the boilerplate should be updated on all of them.

[mdavis-xyz]

What should the boilerplate say for the openshift one?

It currently says:

place your kubeconfig file next to this file, with the same name, but without the .template extension.

The point of this change is that you're not supposed to modify these files or put files into the same folders.
So is "next to this file" incorrect?

I don't understand the point of that file. There's nothing in it. Is it just supposed to be some instructions, which are located in the same place as instructions for other modules?

Should it say:

place your kubeconfig file
into the tests/integration directory of the collection you're testing,
with the same name as this file, but without the .template extension.

[mattclay]

Should it say:

place your kubeconfig file
into the tests/integration directory of the collection you're testing,
with the same name as this file, but without the .template extension.

Yes, that should work. The instructions in all of these template files were created when they originally resided in the test/integration/ directory (before we even had support for collections). The instructions were never updated when the files were moved.

[mdavis-xyz]

Ok, now I've updated all the cloud- files.

[mattclay]

Looks good. Just one minor cosmetic change requested.

[mattclay]

@mdavis-xyz Thanks for fixing this.