Document oidc-agent, fedcloudclient and terraform #515
Conversation
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
1 similar comment
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
|
I've also some bits allowing to prepare some kind of template repository, that could also include |
|
I am getting 404 from https://docs.egi.eu/documentation/515 Not sure if this is related or useful, but I documented some guides here: |
|
The 404 is the usual one when the preview is marked as deployed but not yet reachable for real, now it's here: https://docs.egi.eu/documentation/515/users/tutorials/oidc-agent-fedcloudclient-terraform/ (it's a WIP, some content, like the terraform files, is missing). Currently my position/feeling is to aim at "promoting" tools that are properly maintained by an upstream and that we are sure will stay for long (ie thinks like terraform, oidc-agent and fedcloudclient, compared to home made scripts) , but I think providing a bunch of places/repo where people could look for more advanced stuff would be nice. But drawing the line about what to document or not is always difficult, especially as some stuff may become outdated. Concerning your repositories (nice work!), we may at least want to reference them somewhere, so that people can find them. Maybe we could at least add a section with some references to advanced tools/resources/repositories with a short description? |
|
I agree, there is an inherent peril in maintaining documentation about products and tools that change rapidly, as the documentation becomes outdated and it is impossible to keep up. I shared the links in my comment exactly for the issue you mention: checking if my work could help to avoid duplicated work. There is actually overlapping between my Terraform repository and this new tutorial. As you mention, maybe the best is to link these guides from the docs. This way, if something is not relevant anymore, the link can be easily removed. Or it can be kept to serve as the base for updates or new requests. I think it is important to keep track of this efforts and knowledge, otherwise it will get lost. For example, other people did also a similar exercise with Terraform in the past, but this effort is not registered anywhere. |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
content/en/users/tutorials/oidc-agent-fedcloudclient-terraform/_index.md
Show resolved
Hide resolved
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
content/en/users/tutorials/oidc-agent-fedcloudclient-terraform/_index.md
Outdated
Show resolved
Hide resolved
…/_index.md Co-authored-by: Sebastian Luna-Valero <[email protected]>
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
|
@enolfc, @sebastian-luna-valero is it fine for now? |
…ew resource names in the main.tf
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
Documentation preview deployed!Available at https://docs.egi.eu/documentation/515 |
gwarf
deleted the
quickstart_oidc-agent_fedcloudclient_terraform_vo.access.egi.eu
branch
Document using oidc-agent, fedcloudclient and terraform altogether.
Using Dynamic DNS too.
I had to do this for myself so thought it may be nice to have some kind of of very guided tutorial/setup for starting up with a more advanced CLI usage.