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

@hsolg/in-deploy

v1.1.0

Published

Simple deployment utility.

Downloads

4

Readme

in-deploy

Simple deployment utility.

Deploy any type of software archive via Amazon S3. Convenient if the build machine and the deployment target cannot communicate directly because of NAT etc.

in-deploy is an interactive utility with a number of commands.

  • login
  • add
  • push
  • pull

AWS setup

Create IAM user

  1. Go to IAM -> Users.
  2. Press "Add user".
  3. Enter user name.
  4. Enable "Programmatic access".
  5. Press "Next" a few times and then "Create user".

Create access key

  1. Select the new user in the user overview and select the "Security credentials" tab.
  2. Press "Create access key".
  3. Click on "Show" and save the Access key ID and Secret access key in a safe place.

Create bucket

  1. Go to S3.
  2. Press "Create bucket".
  3. Enter bucket name.
  4. Select a region. Find the corresponding region id here (e.g. eu-west-1) and write it down: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
  5. Press "Next" a few times and then "Create bucket".

Configure bucket access

  1. Select the bucket in the bucket overview.
  2. Select the "Permissions" tab.
  3. Press "Bucket policy".
  4. Enter the policy below.
    • Replace IAM_USER_ID and IAM_USER_NAME with the id and username of the user created above.
    • Replace BUCKET_NAME with the name of the bucket.
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::IAM_USER_ID:user/IAM_USER_NAME"
            },
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::BUCKET_NAME",
                "arn:aws:s3:::BUCKET_NAME/*"
            ]
        }
    ]
}

Usage

login

Enter and store Amazon AWS credentials. The credentials will be stored in a file called .in-deploy-user in the directory where you run the in-deploy executable. You have to run the executable from the same directory if you want to use the credentials later. Make sure you don't commit the credentials file to a public source code repository.

$ in-deploy 
Commands: login | add | push | pull | quit
? Command: login
? Region: <the region where your bucket was created>
? Access key ID: ********************
? Secret access key: ****************************************

add

If you are on a build machine, use this command to register a directory with builds. If you are on a deployment machine, use this command to register a directory where you will store application archives for deployment. The mappings from application names to directories and buckets will be stored in a file called .in-deploy-app in the directory where you run the in-deploy executable. You have to run the executable from the same directory if you want to use the mappings later.

$ in-deploy 
Commands: login | add | push | pull | quit
? Command: add
? Name: <typically an application name>
? Directory: <directory with application archives (relative to current directory)>
? Bucket name: <name of the S3 bucket>

push

Use this command to push an application archive from a build machine to an S3 bucket.

$ in-deploy 
Commands: login | add | push | pull | quit
? Command: push
? Name: <typically an application name>
? File: SomeApplication-x.y.z.zip
Upload <full path>/SomeApplication-x.y.z.zip to <bucket name>
ETag: "********************************"

pull

Use this command to pull an application archive from an S3 bucket to a deployment machine.

$ in-deploy 
Commands: login | add | push | pull | quit
? Command: pull
? Name: <typically an application name>
? File: 
❯ SomeApplication-x.y.z.zip 

quit

Quit in-deploy and return to the shell.

$ in-deploy 
Commands: login | add | push | pull | quit
? Command: quit
$