stratus-red-team icon indicating copy to clipboard operation
stratus-red-team copied to clipboard

docs: add asdf as way to install

Open vthiery opened this issue 11 months ago • 7 comments

What does this PR do?

Document how to install stratus-red-team using asdf. I have also slightly changed how installation methods are listed for clarity.

Motivation

Using asdf and the plugin I wrote for stratus-red-team is a convenient way to use / test different versions of stratus-red-team.

Checklist

NA

vthiery avatar Mar 08 '24 07:03 vthiery

Thanks for the contribution! I'm happy to add asdf support, but I'd like to have the plugin repo as part of the same repo. Is there a way to add it e.g. in a subfolder?

christophetd avatar Mar 08 '24 09:03 christophetd

Thanks for the contribution! I'm happy to add asdf support, but I'd like to have the plugin repo as part of the same repo. Is there a way to add it e.g. in a subfolder?

I believe that the "right" way to maintain asdf plugins is the way it is now: separate from the actual tool. I have raised a PR to add the plugin to the plugins directory: https://github.com/asdf-vm/asdf-plugins/pull/971

If we want more assurance around the maintenance of the plugin, I am happy to transfer ownership to the asdf--community .

What do you think?

vthiery avatar Mar 08 '24 10:03 vthiery

Transfering to asdf-community would be optimal, thank you

christophetd avatar Mar 08 '24 10:03 christophetd

Transfering to asdf-community would be optimal, thank you

Let me proceed with the transfer then and I will update this PR accordingly.

vthiery avatar Mar 08 '24 11:03 vthiery

Hi @vthiery, still eager to merge this, let me know when the transfer happens! Thanks

christophetd avatar Apr 04 '24 10:04 christophetd

Hi @christophetd, I'm still waiting on the asdf-community to initiate the transfer https://github.com/asdf-community/infrastructure/pull/149

vthiery avatar Apr 08 '24 06:04 vthiery

Thanks! I left a comment in the linked PR as well

christophetd avatar Apr 08 '24 09:04 christophetd

@christophetd the repository has been transferred.

vthiery avatar Apr 29 '24 06:04 vthiery

Thanks @vthiery ! Do you have any thoughs on what we should do when a new version of Stratus Red team gets released? I.s. how to bump the asdf version, and how we could automate this?

christophetd avatar Apr 29 '24 10:04 christophetd

@christophetd there is nothing to do from your side as the asdf plugin will be able to retrieve all the releases, including the "latest" as soon as it's released.

As a user, one can simply use asdf install stratus-red-team latest to get the latest release. If one want a specific version, asdf install stratus-red-team 2.15.0 would be the way to go. Users may also do asdf list all stratus-red-team to list all the versions available.

Bonus tip: one can shorten the plugin name when adding it to avoid repeating "stratus-red-team". E.g. asdf plugin add stratus https://github.com/asdf-community/asdf-stratus-red-team.git and then asdf list all stratus.

vthiery avatar Apr 29 '24 11:04 vthiery

Amazing! Thanks for all the work around this

christophetd avatar Apr 29 '24 11:04 christophetd