Skip to content

Add "Best Practice" page ?Β #705

@udf2457

Description

@udf2457

It seems to me that the docs are missing a "best practice" page as there are currently lots of hints in the manual (either explicit or implicit) that really should be consolidated onto a "best practice" page.

For example:

  • The implied best practice on the Updates Streams page that you should consider haivng testing and next canaries
  • The implied best practice in relation to Zincati wariness that some nodes should have a more aggressive value for canary purposes
  • Given CoreOS is a rolling distro, details on how to manage configs between releases (e.g. avoid issues with breaking changes in configs)
  • Probably many tips and tricks for managing Butane files, perhaps especially around merge and replace.

I'm sure there's a bunch of things that battle scarred sysadmins have picked up over the years ? i.e. "I wish somebody told me that when I started using CoreOS".

The CoreOS devs also probably know which cupboards the skeletons are hidden in and could hint at things to avoid because they are flaky / not stable. πŸ˜‰

I'm new to CoreOS but this sort of thing would be very useful when strarting from a greenfield deployment. People should not have to learn the hard way.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions