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

documentation for designate-manage #909

Closed
wants to merge 1 commit into from

Conversation

sjamgade
Copy link

No description provided.

Copy link
Contributor

@kallecarlwa kallecarlwa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

relates to SCRD-8739; not complete yet

designate.md Outdated
-------------------

Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
and records over the network using pools of DNS server. From an Admin's perspective there is not
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

servers

designate.md Outdated

Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
and records over the network using pools of DNS server. From an Admin's perspective there is not
much to configure as the default for deployment are well in place.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe there are steps needed to enable the neutron integration. Is the barclamp doing this automatically?

https://docs.openstack.org/designate/latest/contributor/integrations.html
https://docs.openstack.org/ocata/networking-guide/config-dns-int.html

- designate-worker role
this role configures a designate worker on the selected nodes. Designate uses the workers to distribute
its workload

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if you are not supporting Sink, (a good idea IMHO) , should we mention Sink is not included

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes we should atleast mention it

@sjamgade sjamgade force-pushed the rocky_designate branch 3 times, most recently from fe7b56a to 5113289 Compare April 11, 2019 08:49
Copy link
Collaborator

@asettle asettle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can probably ignore my comments for language changing :) we can fix that!
Makes sense to me. @csymons-suse is there a JIRA card for this? If not, I'm not entirely too sure on our process. Do we need a JIRA card to track these changes? And then, what's our process for converting into XML?

designate.md Outdated
Deploying Designate
-------------------

Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUSE OpenStack Cloud uses Designate (DNS as a Service) to create and propgate zones and records over the network...

designate.md Outdated
-------------------

Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
and records over the network using pools of DNS servers. From an Admin's perspective there is not
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From an administrator's perspective*

designate.md Outdated
Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
and records over the network using pools of DNS servers. From an Admin's perspective there is not
much to configure as the default for deployment are well in place. Neutron needs some additional
settings for integration with desginate[1], the barclamp currently does not configure these but if
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Designate*

designate.md Outdated
settings for integration with desginate[1], the barclamp currently does not configure these but if
required the admin can enable these as required.

This designate barclamp relies heavily on dns barclamp and expects it to be applied without any
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

on the DNS barclamp

designate.md Outdated
failures.

- designate-server role
this role will install the designate server packages and configure mini-dns (mdns) service required
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This role installs the Designate *

designate.md Outdated
by designate

- designate-worker role
this role configures a designate worker on the selected nodes. Designate uses the workers to distribute
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This role configures a Designate worker*

designate.md Outdated

- designate-worker role
this role configures a designate worker on the selected nodes. Designate uses the workers to distribute
its workload
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing a full stop

@kallecarlwa
Copy link
Contributor

You can probably ignore my comments for language changing :) we can fix that!
Makes sense to me. @csymons-suse is there a JIRA card for this? If not, I'm not entirely too sure on our process. Do we need a JIRA card to track these changes? And then, what's our process for converting into XML?

As noted in an earlier (the first) comment...
"relates to SCRD-8739; not complete yet"
https://jira.suse.de/browse/SCRD-8739
I'm working with Sumit on this. He will assign me as worker when the content is ready. Consequently, until I hear from him, I'm assuming that it's not ready.

Until final copy hits GitHub, all activity and progress is tracked in Jira. It has an extensive communication structure that is superior to GitHub for SUSE projects.

In this case, the process for converting into XML...

  • git fetch the original PR
  • use pandoc to convert from Markdown to DocBook5
  • do the editing thing; there is little need to do any editing
    prior to this. Doc Writer just needs the basic content
    and then can polish, request clarification & information.
  • create a new PR with the DocBook file and associated PNG file...
    noting that the new PR supersedes the original PR
    request review from the original author and anyone else involved
  • close the original PR with comment about superseding PR

designate.md Outdated
Designate provides SUSE OpenStack Cloud, DNS as a service. It allows creating and propagating zones
and records over the network using pools of DNS servers. From an Admin's perspective there is not
much to configure as the default for deployment are well in place. Neutron needs some additional
settings for integration with desginate[1], the barclamp currently does not configure these but if
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling: s/desginate/Designate/

much to configure as the default for deployment are well in place. Neutron needs some additional
settings for integration with desginate[1], the barclamp currently does not configure these but if
required the admin can enable these as required.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe go into some more details as to how one would do that. Can the user just add a drop in configuration file for Neutron? Or are there hidden settings in the Neutron barclamp that the user can use?

@jeremy-moffitt
Copy link
Collaborator

is this for https://jira.suse.de/browse/SCRD-8739 ? or another ticket

@kallecarlwa
Copy link
Contributor

is this for jira.suse.de/browse/SCRD-8739 ? or another ticket

yes, SCRD-8739

@asettle
Copy link
Collaborator

asettle commented Apr 12, 2019

You can probably ignore my comments for language changing :) we can fix that!
Makes sense to me. @csymons-suse is there a JIRA card for this? If not, I'm not entirely too sure on our process. Do we need a JIRA card to track these changes? And then, what's our process for converting into XML?

As noted in an earlier (the first) comment...
"relates to SCRD-8739; not complete yet"
https://jira.suse.de/browse/SCRD-8739
I'm working with Sumit on this. He will assign me as worker when the content is ready. Consequently, until I hear from him, I'm assuming that it's not ready.

Until final copy hits GitHub, all activity and progress is tracked in Jira. It has an extensive communication structure that is superior to GitHub for SUSE projects.

In this case, the process for converting into XML...

  • git fetch the original PR
  • use pandoc to convert from Markdown to DocBook5
  • do the editing thing; there is little need to do any editing
    prior to this. Doc Writer just needs the basic content
    and then can polish, request clarification & information.
  • create a new PR with the DocBook file and associated PNG file...
    noting that the new PR supersedes the original PR
    request review from the original author and anyone else involved
  • close the original PR with comment about superseding PR

THANK YOU CARL! :D

@kallecarlwa
Copy link
Contributor

when complete will be superseded by
#931
please advise when content for this PR is complete

@kallecarlwa
Copy link
Contributor

superseded by #931

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

Successfully merging this pull request may close these issues.

6 participants