Metadata-Version: 2.1
Name: tccbsmig
Version: 1.0b1
Summary: CBS Data Migration to Encrypted Disk
Home-page: UNKNOWN
Author: Minze Tao
Author-email: minzetaos@tencent.com
License: MIT
Keywords: Python CBS Ecryption Migration
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: paramiko
Requires-Dist: tencentcloud-sdk-python

1. Tccbsmig
Tccbsmig is designed to batch transfer all the data on an unencrypted CBS to an encrypted CBS for Tencent Cloud. To use it, you need to prepare a JSON file as an input, which includes your account SecrectID, SecrectKey, and all related CVM Instances and storages information.

2. How to use tccbsmig
usage: tccbsmig [-h] -f FILE [-V]

3. How to prepare the JSON file
Attributes' value share the same rules of the APIs that used in this program if applicable.
API used in this program:
CreateDisks: https://intl.cloud.tencent.com/document/api/362/16312
AttachDisks: https://intl.cloud.tencent.com/document/api/362/16313
DetachDisks: https://intl.cloud.tencent.com/document/api/362/16316

An example of qualified JSON file is on the end of this doc.

JSON file structure explaination:
Credentials - this attribute is used to store credentials
  SecrectID - your account SecrectID
  SecrectKey - your account SecrectKey
CBS_Cases - stores all instances and block storages details
  CBS_1 - the name of each case. You can modify case's name to whatever you want.
    InstanceDetail - instance Detail
      InstanceId (String)- instance ID of your instance
      InstancePublicIP (String)- public IP address of your instance
      InstanceName (String)- your instance's name
      Region (String)- the region your instance is in
      Zone (String)- the availability zone your instance is in
      ProjectId (Int)- the project ID of your instance.
      Username (String)- username that used to log in your instance
      SSHKeyPath (String)- SSH Key file location
    CBSDetail - CBS detail
      DiskId (String)- the disk ID of your CBS
      DiskType (String)- the disk type of your CBS
      DiskSize (Int)- the size of your disk
      CBSPathOnCVM (String)- mount point of your disk
      FileSystem (String)- the file system your disk uses
      DiskName (String)- your disk name
      Tags (String)- tag of your disk. If you don't have it, leave an empty string here.

4. JSON file example
{
  "Credentials":{
    "SecrectID":"AKID****************",
    "SecrectKey":"1nKc*****************"
  },

  "CBS_Cases":{
    "CBS_1":
    {
      "InstanceDetail":{
        "InstanceId": "ins-3u***yg1",
        "InstancePublicIP": "175.***.***.101",
        "InstanceName":"ebs-en-test",
        "Region": "ap-shanghai",
        "Zone": "ap-shanghai-3",
        "ProjectId": 111***1,
        "Username": "ubuntu",
        "SSHKeyPath": "/Path-to-SSHKey/SSHKey.dms"
      },
      "CBSDetail":{
        "DiskId": "disk-q9***f8n",
        "DiskType": "CLOUD_PREMIUM",
        "DiskSize": 50,
        "CBSPathOnCVM": "/data",
        "FileSystem":"ext4",
        "DiskName": "diskname",
        "Tags": ""
      }
    },
    "CBS_2":
    {
      "InstanceDetail":{
        "InstanceId": "ins-3b***6e8",
        "InstancePublicIP": "106.***.***.136",
        "InstanceName":"un-en-test",
        "Region": "ap-guangzhou",
        "Zone": "ap-guangzhou-3",
        "ProjectId": 111***1,
        "Username": "ubuntu",
        "SSHKeyPath": "/Path-to-SSHKey/SSHKey.dms"
      },
      "CBSDetail":{
        "DiskId": "disk-ef***3pe",
        "DiskType": "CLOUD_PREMIUM",
        "DiskSize": 30,
        "CBSPathOnCVM": "/data",
        "FileSystem":"ext4",
        "DiskName": "un-test",
        "Tags": "[{\"Key\":\"TagKey\",\"Value\":\"TagValue\"}]"
      }
    }
  }
}

For more information about Tencent Cloud, please visit: https://intl.cloud.tencent.com
Cloud Virtual Machine: https://intl.cloud.tencent.com/product/cvm
Cloud Block Storage: https://intl.cloud.tencent.com/product/cbs


