Скачать troposphere - troposphere скачать исходный код

тропосфера

О

тропосфера — библиотека для создания описаний AWS CloudFormation

Библиотека тропосферы позволяет упростить создание JSON AWS CloudFormation путем написания кода Python для описания ресурсов AWS. тропосфера также включает некоторую базовую поддержку ресурсов OpenStack через Heat.

Чтобы облегчить обнаружение ошибок CloudFormation или JSON на ранней стадии, библиотека имеет встроенную в классы проверку свойств и типов.

Установка

тропосферу можно установить с помощью системы распространения pip для Python, выполнив:

$ pip install troposphere

Чтобы установить тропосферу с помощью AWAC (рекомендуемая мягкая зависимость):

$ pip install troposphere[policy]

Альтернативно вы можете использовать setup.py для установки, клонировав этот репозиторий и выполнив:

$ python setup.py install  # you may need sudo depending on your python installation

Примеры

Простой пример создания экземпляра будет выглядеть так:

 > >> from troposphere import Ref , Template
> >> import troposphere . ec2 as ec2
> >> t = Template ()
> >> instance = ec2 . Instance ( "myinstance" )
> >> instance . ImageId = "ami-951945d0"
> >> instance . InstanceType = "t1.micro"
> >> t . add_resource ( instance )
< troposphere . ec2 . Instance object at 0x101bf3390 >
> >> print ( t . to_json ())
{
    "Resources" : {
        "myinstance" : {
            "Properties" : {
                "ImageId" : "ami-951945d0" ,
                "InstanceType" : "t1.micro"
            },
            "Type" : "AWS::EC2::Instance"
        }
    }
}
> >> print ( t . to_yaml ())
Resources :
    myinstance :
        Properties :
            ImageId : ami - 951945 d0
            InstanceType : t1 . micro
        Type : AWS :: EC2 :: Instance

Альтернативно, вместо свойств можно использовать параметры:

 > >> instance = ec2 . Instance ( "myinstance" , ImageId = "ami-951945d0" , InstanceType = "t1.micro" )
> >> t . add_resource ( instance )
< troposphere . ec2 . Instance object at 0x101bf3550 >

А add_resource() возвращает объект, чтобы его было проще использовать с Ref() :

 > >> instance = t . add_resource ( ec2 . Instance ( "myinstance" , ImageId = "ami-951945d0" , InstanceType = "t1.micro" ))
> >> Ref ( instance )
< troposphere . Ref object at 0x101bf3490 >

Примеры проверки ошибок (полные обратные трассировки удалены для ясности):

На ресурсе AWS установлено неверное свойство:

 > >> import troposphere . ec2 as ec2
> >> ec2 . Instance ( "ec2instance" , image = "i-XXXX" )
Traceback ( most recent call last ):
...
AttributeError : AWS :: EC2 :: Instance object does not support attribute image

Неправильный тип свойства ресурса AWS:

 > >> ec2 . Instance ( "ec2instance" , ImageId = 1 )
Traceback ( most recent call last ):
...
TypeError : ImageId is < type 'int' > , expected < type 'basestring' >

Отсутствует необходимое свойство для ресурса AWS:

 > >> from troposphere import Template
> >> import troposphere . ec2 as ec2
> >> t = Template ()
> >> t . add_resource ( ec2 . Subnet ( "ec2subnet" , VpcId = "vpcid" ))
< troposphere . ec2 . Subnet object at 0x100830ed0 >
> >> print ( t . to_json ())
Traceback ( most recent call last ):
...
ValueError : Resource CidrBlock required in type AWS :: EC2 :: Subnet ( title : ec2subnet )

Поддерживаемые в настоящее время типы ресурсов

Типы ресурсов AWS
Типы ресурсов OpenStack

Дублирование образца одного экземпляра будет выглядеть так

 # Converted from EC2InstanceSample.template located at:
# http://aws.amazon.com/cloudformation/aws-cloudformation-templates/

from troposphere import Base64 , FindInMap , GetAtt
from troposphere import Parameter , Output , Ref , Template
import troposphere . ec2 as ec2


template = Template ()

keyname_param = template . add_parameter ( Parameter (
    "KeyName" ,
    Description = "Name of an existing EC2 KeyPair to enable SSH "
                "access to the instance" ,
    Type = "String" ,
))

template . add_mapping ( 'RegionMap' , {
    "us-east-1" :      { "AMI" : "ami-7f418316" },
    "us-west-1" :      { "AMI" : "ami-951945d0" },
    "us-west-2" :      { "AMI" : "ami-16fd7026" },
    "eu-west-1" :      { "AMI" : "ami-24506250" },
    "sa-east-1" :      { "AMI" : "ami-3e3be423" },
    "ap-southeast-1" : { "AMI" : "ami-74dda626" },
    "ap-northeast-1" : { "AMI" : "ami-dcfa4edd" }
})

ec2_instance = template . add_resource ( ec2 . Instance (
    "Ec2Instance" ,
    ImageId = FindInMap ( "RegionMap" , Ref ( "AWS::Region" ), "AMI" ),
    InstanceType = "t1.micro" ,
    KeyName = Ref ( keyname_param ),
    SecurityGroups = [ "default" ],
    UserData = Base64 ( "80" )
))

template . add_output ([
    Output (
        "InstanceId" ,
        Description = "InstanceId of the newly created EC2 instance" ,
        Value = Ref ( ec2_instance ),
    ),
    Output (
        "AZ" ,
        Description = "Availability Zone of the newly created EC2 instance" ,
        Value = GetAtt ( ec2_instance , "AvailabilityZone" ),
    ),
    Output (
        "PublicIP" ,
        Description = "Public IP address of the newly created EC2 instance" ,
        Value = GetAtt ( ec2_instance , "PublicIp" ),
    ),
    Output (
        "PrivateIP" ,
        Description = "Private IP address of the newly created EC2 instance" ,
        Value = GetAtt ( ec2_instance , "PrivateIp" ),
    ),
    Output (
        "PublicDNS" ,
        Description = "Public DNSName of the newly created EC2 instance" ,
        Value = GetAtt ( ec2_instance , "PublicDnsName" ),
    ),
    Output (
        "PrivateDNS" ,
        Description = "Private DNSName of the newly created EC2 instance" ,
        Value = GetAtt ( ec2_instance , "PrivateDnsName" ),
    ),
])

print ( template . to_json ())

Сообщество

У нас есть группа Google Cloudtools-dev, где вы можете задавать вопросы и общаться с тропосферным сообществом. Проблемы и запросы на включение всегда приветствуются!