https://github.com/cypherpunkarmory/userland-cloud

Userland Cloud API
https://github.com/cypherpunkarmory/userland-cloud

Last synced: 9 days ago
JSON representation

Userland Cloud API

• Host: GitHub
• URL: https://github.com/cypherpunkarmory/userland-cloud
• Owner: CypherpunkArmory
• License: agpl-3.0
• Created: 2019-05-21T23:14:51.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-11-02T06:32:48.000Z (about 5 years ago)
• Last Synced: 2023-03-02T05:35:43.755Z (over 1 year ago)
• Language: Python
• Homepage:
• Size: 3.44 MB
• Stars: 15
• Watchers: 7
• Forks: 10
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/62df8afdbbe64aeb92e32be409932f6e)](https://www.codacy.com/app/CypherpunkArmory/userland-cloud?utm_source=github.com&utm_medium=referral&utm_content=CypherpunkArmory/userland-cloud&utm_campaign=Badge_Grade)

[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/62df8afdbbe64aeb92e32be409932f6e)](https://www.codacy.com/app/CypherpunkArmory/userland-cloud?utm_source=github.com&utm_medium=referral&utm_content=CypherpunkArmory/userland-cloud&utm_campaign=Badge_Coverage)

[![CircleCI](https://circleci.com/gh/CypherpunkArmory/userland-cloud.svg?style=svg)](https://circleci.com/gh/CypherpunkArmory/userland-cloud)

# Userland Cloud

This is the code used to run [https://userland.tech](https://userland.tech) 


Visit [userland.tech](https://userland.tech) to find out more

# Setting Up

The Userland Cloud nomad cluster requires a loopback alias in order to communicate

with containers running on the MacOS version of docker.

If you are running on a Mac, you can create this loopback alias at

172.16.123.1 by running `task setup_net`

If you are running locally, you will need to set the sshendpoint in your `.punch.toml`

file to this address as well.

This step is not necessary for running on Linux - but you will probably need

to change the `SEA_HOST` environment variable to your local IP.

1. You will need a dockerhub account to run the app.

2. Create a virtualenv (using pyenv) called "userland" based on Python 3.7.0

3. Install go-task via homebrew

4. Run `task setup_db setup_net`

5. Run the tests  `docker-compose run web pytest`

# Common Commands

## Run Flask Shell

`docker-compose run -e "FLASK_APP=app:create_app('development')" web python -m flask shell`

## Exec into a container

Most of the containers do not have bash so you'll need to use regular old sh.

`docker ps` -> note the _container id_

`docker exec -it  /bin/sh`

# Deploying Userland Cloud

Contributors and Userland Cloud Developers

1. Spin up a pushbutton environment using Grid.

2. Login to the Pushbutton VPN

3. Cd into the deploy directory and create a Userland Cloud workspace with the _same

   name_ as your Pusbutton

4. Push a release to Docker Hub - for development it will deploy a tag with

   your branch name.  If you're on master, it will create a tag release.

5. task deploy WORKSPACE=

  - If you are on master it will create new tags incremented by 0.0.1 and

    release those

  - You can specify a version using the VER variable.