Skip to main content

pcf

Project description

Build Status Build Status Licence PyPi Version Supported Python Versions

Particle Cloud Framework

Particle Cloud Framework is a cloud resource provisioning framework that is fully customizable and extensible, callable by code, and does not require manually maintaining states of resources. Particle Cloud Framework enables the standardization of modeling hierarchical cloud infrastructure, automating deployments, and managing lifecycles of cloud resources.

Docs

Docs including quickstart and developer guide

Installation

To install particle cloud framework, open an interactive shell and run:

pip install pcf

Import and use a PCF Particle

First import the particles you will use. These can be core particles or custom particles that you created. See examples if you need help creating your config.

from pcf.core.ec2.ec2_instance import EC2Instance

Next we need to pass the desired state definition to the particle.

    ec2_example_definition = {
        "pcf_name": "ec2_example",
        "flavor":"ec2",
        "aws_resource": {
            "ImageId": "ami-xxxxx",
            "InstanceType": "t2.micro",
            "KeyName": "secret-key-xxx",
            "SecurityGroupIds": [
              "sg-xxxxxx",
            ],
            "SubnetId": "subnet-xxx",
            "userdata_template_file": "userdata-script-xxxxx.sh",
            "userdata_params": {},
            "IamInstanceProfile": {
              "Arn": "arn:aws:iam::xxxxxxxxx"
            },
            "InstanceInitiatedShutdownBehavior": "stop",
            "tags": {
              "NAME":"Value"
            },
            "BlockDeviceMappings": [
              {
                "DeviceName": "/dev/sda1",
                "Ebs": {
                  "DeleteOnTermination": true,
                  "VolumeSize": 20,
                  "VolumeType": "gp2"
                }
              }
            ]
          }
    }

Now to start the ec2 instance using pcf simply initialize the particle and set the desired state to running and apply.

    particle = EC2Instance(ec2_example_definition)

    particle.set_desired_state('running')
    particle.apply()

To terminate simply change the desired state to terminated and apply.

    particle.set_desired_state('terminated')
    particle.apply()

Published Content

Just in Time Cloud Infrastructure: Redefining the Relationship Between Applications and Cloud Infrastructure

Supported Cloud Services

Particles

Quasiparticles

Development Setup

To develop locally, clone this project and ensure you have the Invoke package installed globally via pip or conda:

$ pip install invoke

or

$ conda install invoke

Then you can use the project management tasks defined in tasks.py via the invoke CLI:

$ invoke --list
Available tasks:

  build      Build PCF with the PCF_TAG value given or the VERSION in pcf/__init__.py
  docs-add   Run sphinx-apidoc on pcf and pcf/test
  lint       Run pylint on pcf directory
  publish    Publish package to Pypi
  setup      Setup a virtualenv, activate it, and install requirements
  test       Run pytest on pcf directory, generating a coverage report

$ invoke setup && source venv/bin/activate
$ invoke test

RoadMap

Roadmap

Contributors

We welcome Your interest in Capital One’s Open Source Projects (the “Project”). Any Contributor to the Project must accept and sign an Agreement indicating agreement to the license terms below. Except for the license granted in this Agreement to Capital One and to recipients of software distributed by Capital One, You reserve all right, title, and interest in and to Your Contributions; this Agreement does not impact Your rights to use Your own Contributions for any other purpose.

Sign the Individual Agreement

Sign the Corporate Agreement

Code of Conduct

This project adheres to the Open Code of Conduct By participating, you are expected to honor this code.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pcf-0.4.4-py3-none-any.whl (193.2 kB view details)

Uploaded Python 3

File details

Details for the file pcf-0.4.4-py3-none-any.whl.

File metadata

  • Download URL: pcf-0.4.4-py3-none-any.whl
  • Upload date:
  • Size: 193.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for pcf-0.4.4-py3-none-any.whl
Algorithm Hash digest
SHA256 957fc16772cbf58e304ca2fbd15033ea624ddd5acc9e93a14be0eb049e531306
MD5 4bf2b6c6c8ad66a5452736648418acfd
BLAKE2b-256 801d707d9d0a4809a8bc5ce3f2694eee5d6ce9b7b7b50f758aac31bd17aac506

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page