npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@torus-tools/stack

v0.0.125

Published

A promise-based SDK for generating, deploying and managing stacks in AWS with cloudformation.

Downloads

1

Readme

Torus Stack

A promise-based javascript SDK that generates and deploys JSON cloudformation templates for static websites in AWS. It uses the AWS SDK to create, and execute changesets in a particular sequence that enables automation of the entire process while maintaining a short deployment time.

You are free to customize the generated cloudformation template or its resources individually in any way you want using the AWS console/CLIs/SDKs and/or the torus stack SDK/CLI command. You can also push the arjan_config to github and enable other team-members (with permission) to collaborate on the stack.

Features

  • Creates a single cloudformation template
  • Saves your cloudformation changesets locally
  • Automatically imports existing resources for a given domain in AWS
  • Adds continous deployment with github using codepipeline
  • Completely open source
  • Responsive community support 🙂

Getting Started

Prerequisites

  • An AWS account
  • node and npm
  • The latest version of the Arjan CLI

Deploy a static site with a CDN and HTTPS

  • pop up your terminal, go into your desired project cd project_name, and run arjan stack create prod

  • When using Torus Tools you are using your own AWS account from your own machine.

  • Any charges incurred by your websites will be billed directly from AWS to your AWS account.

  • Torus Tools does NOT have any access to your AWS account/bill.

Architecture

Because the content in a static site doesnt have to be processed on a request basis it can be served completely from a server’s cache, or a cheaper cloud based object storage solution like AWS s3. To place the content closer to the end users, provide faster response times, and a secure url, a CDN (content distribution network) can be added.

The CDN fetches contet from the origin (s3 bucket) and distributes it to several edge locations scattered around the globe.

setups

For an easier development workflow we have defined some setups that include Dev, Test and Prod (production). You can customize these by additionally providing flags.

dev → test → prod

  1. Dev: public S3 bucket
  2. Test: public S3 root bucket, www reroute bucket and a route53 hosted zone.
  3. Prod: public S3 root bucket, www reroute bucket, route53 hosted zone, cloudfront distribution, ACM certificate

How it Works

The Torus Stack SDK has a series of methods that take care of generating/provisioning cloudformation templates. The deployment process for a complete stack will first deploy a cloudformation template with an s3 bucket, public policy and a hosted zone. Then it will update it with a cloudfront distribution.

If there are existing buckets/cdn's/hosted zones for the given domain, torus will propmpt you to confirm if you want to import those resources.

Cost breakdown (from AWS)

This is a breakdown of the costs of hosting a static site in AWS Let’s say your website uses CloudFront for a month (30 days), and the site has 1,000 visitors each day for that month. Each visitor clicked 1 page that returned a single object (1 request) and they did this once each day for 30 days. Turns out each request is 1MB for the amount of data transferred, so in total for the month that comes to 30,000MB or 29GB (1GB = 1,024MB). Half the requests are from the US and half are from Europe, so your monthly total for data transferred comes to $2.47. Also, each click is an HTTP request, so for the month that equals 30,000 HTTP requests, which comes to a total of $0.02 for the month. Adding the two values together, the total cost for using CloudFront for this example would be $2.49 for the month.

| Resource | Consumption | Cost | | -------------- | -------------------- | ---------- | | Cloudfront | 29GB bandwith | $ 2.47 | | Cloudfront | 30,000 http requests | $ 0.02 | | Route53 | 1 Hosted Zone | $ 0.50 | | s3 | 5GB storage | $ 0.15 | | Total Cost | ------------------ | $ 3.14 |

Programmatic Usage

const {deployStack} = require('../lib/deployStack')

deployStack('testingsit.com', {bucket:true}, {index:'index.html', error:'error.html', providers:{bucket:'aws'}}, true)

API

stackExists(domain)

  • description: determines wether or not a stack exists for a given domain. If it does exist it returns the stack's ID.
  • params: (domain)
    • domain: STRING: REQUIRED: the root domain of your site i.e. yoursite.com
  • returns: promise(resolve, reject)
    • resolve: (stackID | null)
      • stackID: STRING: ID or ARN (Amazon resource number) of the existing resource
    • reject: (error)

resourceExists.resource(domain)

  • description: determines wether or not a particular resource exists for a given domain. If it does exist it returns the resource's ID/ARN Resources include:
    • CloudFrontDist
    • RootBucket
    • HostedZone
    • AcmCertificate
  • params: (domain)
    • domain: STRING: REQUIRED: the root domain of your site i.e. yoursite.com
  • returns: promise(resolve, reject)
    • resolve: (ResourceID | null)
      • resourceID: STRING: ID or ARN (Amazon resource number) of the existing resource
    • reject: (error)

generateTemplate(domain, stack, config, template, overwrite)

  • description: Generates a cloudformation template for a given domain
  • params: (domain, stack, config, template, overwrite)
    • domain: STRING: REQUIRED: the root domain of your site i.e. yoursite.com
    • stack: OBJECT: REQUIRED: Contains the desired resources for the given stack with boolean values
        const stack = {
        bucket: true,
        www: true,
        dns: true,
        cdn: false,
        https: false
      }
    • config: OBJECT: REQUIRED: Stack configuration. Contains the desired providers for each resource as well as the index and error documents.
      const config = {
        index:"index.html",
        error:"error.html",
        last_deployment:"",
        providers: {
          domain: 'godaddy',
          bucket: 'aws',
          cdn: 'aws',
          dns: 'aws',
          https: 'aws'
        }
      }
    • template: OBJECT: An existing JSON cloudformation template that you wicsh to modify
    • overwrite: BOOLEAN: Set as true if you wish to overwrite the existing template with the generated template. By default, only new resources are added to the existing template.
  • returns: promise(resolve, reject)
    • resolve: ({"template":{}, "existingResources":[]})
      • template: OBJECT: the generated cloudformation template
      • existingResource: ARRAY: an array of resources that exist for the given domain that should be imported into the template
    • reject: (error)