[RFC0034] App Manifests v2

[beyhan]

This issue tracks the implementation of RFC-0034: App Manifests v2.

Tasks

• Endpoint for viewing supported API versions
• CAPI release feature flag
• Apply empty v2 manifest
• CATS/BARAS Test(s)
• V1 Manifest Parity
  • Generate diff for v2 manifest
  • Apply v2 manifest with fields currently supported by v1 manifests
  • Resource-level declarative configuration
• New V2 Fields
  • Routing
    • Process types
    • App ports
    • Metadata
  • Services
    • Provisioning
    • Updating
    • Route bindings
    • Keys
    • Metadata
  • Apps
    • Features
    • State
    • Metadata
• CLI Support
• Declarative pruning/resource deletion
• Experimental Features
  • Droplets
  • Remote Files
  • Fallback URLs
  • Resource sharing
  • Network polices
  • Route options

[norman-abramovitz]

There was convention that got lost over time. The use of underscores was for names given that what is most programming languages used. Dashes was used to separate combined keys like combining GUIDS. The colon was to separate major components like it does in the /etc/passwd file. If you are considering moving towards only underscores, you should consider a convention that covers all known usages and provide some form of escaping or mapping functions when an outside process needs a format.

If you want additional information, you can contact me through slack or github.

[norman-abramovitz]

When breaking out components like services into their own top level item, please do not lose the knowledge how those components relate back to the other other components. A person should be able see or draw a graph of the relationships. What I saw in the example cases the relationships are lost.

If you want additional information, you can contact me through slack or github.

[norman-abramovitz]

I hope we do not rename the manifest or have a better name than "space manifest." I feel it needs to make sense to the role that the api/cli interface is was designed for. Unless you are planning to put all pushed processes into a single space manifest, the use of the term "space manifest" would be very confusing. It is possible to design an interface where it makes sense but that might be V4 interface.

If you want additional information, you can contact me through slack or github.