Metadata-Version: 1.1
Name: gcpdns
Version: 1.2.6
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
Description: ======
        gcpdns
        ======
        
        A Python module and CLI for managing zones and resource record sets on Google Cloud DNS
        
        ::
        
            Usage: gcpdns [OPTIONS] CREDENTIAL_FILE COMMAND [ARGS]...
        
            gcpdns: A CLI for managing resource records 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.
        
        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
        
        Setup
        -----
        
        To use ``gcpdns``, you'll need a separate `service account`_ credentials JSON
        file for each 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
        
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
