Metadata-Version: 2.1
Name: gcpdns
Version: 1.2.9
Summary: A Python module and CLI for managing zones and resource record sets on Google Cloud DNS
Home-page: https://domainaware.github.io/gcpdns
Author: Sean Whalen
Author-email: whalenster@gmail.com
License: Apache 2.0
Keywords: Google Cloud,GCP,DNS
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: google-api-python-client
Requires-Dist: google-cloud
Requires-Dist: google-cloud-dns
Requires-Dist: publicsuffix2
Requires-Dist: click

======
gcpdns
======

A Python module and CLI for managing zones and resource record sets on Google Cloud DNS

Features
--------

- Dump all project zones names in CSV and/or JSON format
- Dump all zone resource record sets in CSV and/or JSON format
- Create and delete zones via CLI or CSV
- Create and delete resource record sets via CLI
- Update DNS resource records for multiple zones in one project using one CSV
  file
- Automatically split ``TXT`` records longer than 255 characters when publishing
- Automatically add an ending ``.`` to records when needed

CLI
---

::

    Usage: gcpdns [OPTIONS] CREDENTIAL_FILE COMMAND [ARGS]...

      gcpdns: A CLI for managing zones and resource record sets on Google Cloud
      DNS.

    Options:
      --version  Show the version and exit.
      --verbose  Enable verbose logging.
      --help     Show this message and exit.

    Commands:
      record  Manage DNS resource record sets.
      zone    Manage DNS zones.


gcpdns record
~~~~~~~~~~~~~

::

    Usage: gcpdns record [OPTIONS] COMMAND [ARGS]...

      Manage DNS resource record sets.

    Options:
      --help  Show this message and exit.

    Commands:
      create  Create a resource record set (Data fields separated by |).
      delete  Delete a resource record set
      dump    Dump a list of DNS resource records.
      update  Create, replace, and delete resource record sets using a CSV file.

gcpdns zone
~~~~~~~~~~~

::

    Manage DNS zones.

    Options:
      --help  Show this message and exit.

    Commands:
      create  Create a DNS zone.
      delete  Delete a DNS zone and all its resource records.
      dump    Dump a list of DNS zones.
      update  Create and delete zones using a CSV file.

Installation
------------

Use ``pip`` (or ``pip3`` for Python 3).

::

    sudo -H pip install gcpdns

Setup
-----

To use ``gcpdns``, you'll need a separate `service account`_ credentials JSON
file for each GCP project that you want to work with.

Ensure that the Service Account has the proper permissions to edit DNS
(e.g. the DNS Administrator role) in the project.

Zone CSV fields
---------------

- ``action``

  - ``create`` - Creates a zone
  - ``delete`` - Deletes a zone

- ``dns_name``    - The zone's DNS name
- ``gcp_name``    - The zone's name in GCP (optional)
- ``description`` - The zone's description (optional)



Record CSV fields
-----------------

- ``action``

  - ``create`` - Creates a resource record set
  - ``replace`` - The same as ``create``, but will replace an existing resource
    record set with the same ``name`` and ``record_type`` (if it exists)
  - ``delete`` - Deletes a resource record set

- ``name`` - The record set name (i.e. the Fully-Qualified Domain Name)
- ``record_type`` - The DNS record type
- ``ttl`` - DNS time to live (in seconds)
- ``data`` - DNS record data separated by ``|``

.. _service account: https://cloud.google.com/iam/docs/creating-managing-service-accounts


