X Tutup
The Wayback Machine - https://web.archive.org/web/20200914053222/https://github.com/github/octodns/pull/200
Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Changes recommended structure of config files #200

Open
wants to merge 3 commits into
base: master
from
Open

Conversation

@ad-m
Copy link

ad-m commented Feb 18, 2018

Keeping everything in one directory made it difficult for me to understand what the expected directory structure is. Hence, it proposes to separate the basic configuration of the environment from the detailed configuration of the zones.

Copy link
Contributor

ross left a comment

Mostly agree with this change. I think I'd prefer not to suggest env as a first class thing through. What do you think about including the zones/ suggestion for where the zone files live, but leaving the general config stuff under config/?

@@ -79,7 +79,7 @@ Further information can be found in [Records Documentation](/docs/records.md).
We're ready to do a dry-run with our new setup to see what changes it would make. Since we're pretending here we'll act like there are no existing records for `example.com.` in our accounts on either provider.

```
$ octodns-sync --config-file=./config/production.yaml
$ octodns-sync --config-file=./env/production.yaml

This comment has been minimized.

@ross

ross Feb 20, 2018

Contributor

env would be a common case for how to break these down, but not the only one. E.g. we might separate the public important zones, from the very static and seldom touched vanity redirects like gtihub.com -> github.com, and separate the constantly changing internal zones into yet another config. All of these would be "production", but there'd be (in this case) 3 different setups.

This comment has been minimized.

@ad-m

ad-m Feb 20, 2018

Author

@ross , maybe there is another name that will actually describe the content? config matches everything. Maybe inventory?

This comment has been minimized.

@ross

ross Mar 3, 2018

Contributor

I think I'd like to stick to config/ here since it's "config" for octoDNS itself. Inventory doesn't really seem to line up to me and I've not come up with anything else that seems to encompass all the cases.

@@ -60,7 +60,7 @@ Further information can be found in the `docstring` of each source and provider

Now that we have something to tell OctoDNS about our providers & zones we need to tell it about or records. We'll keep it simple for now and just create a single `A` record at the top-level of the domain.

`config/example.com.yaml`
`zones/example.com.yaml`

This comment has been minimized.

@ross

ross Feb 20, 2018

Contributor

The zones change makes sense.

@ad-m
Copy link
Author

ad-m commented Feb 20, 2018

I - at the time of README reading - at some point I got the impression that we need to create a nested config/config directory. Hence the will to change the name of config directory. It may be worth explaining it in a different way.

ad-m added 2 commits Feb 25, 2018
@ad-m
Copy link
Author

ad-m commented Oct 24, 2019

Is there anything what I can do to help merge that PR?

@ross
Copy link
Contributor

ross commented Oct 26, 2019

Is there anything what I can do to help merge that PR?

As mentioned in the review. The zones change makes sense, but I'd rather than recommend the env/ change as the config files aren't always tied to the environment (prod/staging/dev.) Sometimes they're split up other ways, e.g. config/production.yaml and config/secondary.yaml where secondary has things that essentially never change, other TLDs, type-os, mis-spellings, ...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

2 participants
You can’t perform that action at this time.
X Tutup