Skip to content

Commit

Permalink
docs: update README
Browse files Browse the repository at this point in the history
  • Loading branch information
jimbrig committed Sep 11, 2024
1 parent aee1063 commit 1988447
Showing 1 changed file with 64 additions and 8 deletions.
72 changes: 64 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,74 @@
# R Shiny App on GCP Cloud Run Demo
<h1 align="center">R Shiny App on GCP Cloud Run Demo</h1>

<p align="center"><a href="CHANGELOG.md">Changelog</a> &middot; <a href="https://docs.noclocks.dev/gmhleasrdemo-rshiny-cloudrun/">Documentation</a> &middot; <a href="https://github.com/noclocks/demo-rshiny-cloudrun/pkgs/container/demo-rshiny-cloudrun">Docker Containers</a></p>

<p align="center">
<img src="man/figures/r-shiny.webp" width="100px" height="auto" alt="R Shiny"/>
<img src="man/figures/cloud-run.png" width="100px" height="auto" alt="Google Cloud Run"/>
</p>

<p align="center">
<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&pause=1000&center=true&vCenter=true&multiline=true&width=450&height=80&lines=R+Shiny+Google+Cloud+Run;Built+by+No+Clocks%2C+LLC" alt="Typing SVG"/>
</p>

***

> [!NOTE]
> This is an R package built by [No Clocks, LLC](https://noclocks.dev) for demonstration purposes.
> It aims to showcase how to develop and deploy an R Shiny app as a package to Google Cloud Platform's (GCP) Cloud Run
>service using Docker.
***

## Contents


## Badges

<!-- badges: start -->
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[![Build and Push to GHCR](https://github.com/noclocks/demo-rshiny-cloudrun/actions/workflows/docker-ghcr.yml/badge.svg)](https://github.com/noclocks/demo-rshiny-cloudrun/actions/workflows/docker-ghcr.yml)
[![Build and Deploy to Cloud Run](https://github.com/noclocks/demo-rshiny-cloudrun/actions/workflows/docker-gcp.yml/badge.svg)](https://github.com/noclocks/demo-rshiny-cloudrun/actions/workflows/docker-gcp.yml)
<!-- badges: end -->

## Overview

> [!NOTE]
> This repository houses a demonstration R package that showcases how to develop
> and deploy an R Shiny app to Google Cloud Platform's (GCP) Cloud Run service
> using Docker.
This repository contains an R package that demonstrates how to build and deploy an R Shiny app to Google Cloud Platform's
(GCP) Cloud Run service using Docker.

## Contents
## Installation

## Overview
You can install the development version of `rshinycloudrun` from GitHub with your preferred installation method below:

> [!WARNING]
> Notice that although the R package is named `rshinycloudrun`, the GitHub repository is named `demo-rshiny-cloudrun`.
> This is for internal organization purposes and should not affect the installation process.
```r
# Install using remotes
remotes::install_github("noclocks/demo-rshiny-cloudrun")

# Or using devtools
devtools::install_github("noclocks/demo-rshiny-cloudrun")

# Or using pak
pak::pkg_install("noclocks/demo-rshiny-cloudrun")
```

## Usage

## Pre-Requisites
Once installed, you can load the package and run the Shiny app using the following commands:

```r
library(rshinycloudrun)
run_app()
```

## Deployment

The package is set up to build and deploy the R Shiny app to Google Cloud Platform's (GCP) Cloud Run service using Docker.

### Pre-Requisites

1. [Google Cloud Platform (GCP) Account](https://cloud.google.com/)
2. [Docker Desktop](https://www.docker.com/products/docker-desktop)
Expand All @@ -31,3 +83,7 @@
Please note that the `rshinycloudrun` package is released with a
[Contributor Code of Conduct](https://contributor-covenant.org/version/2/1/CODE_OF_CONDUCT.html).
By contributing to this project, you agree to abide by its terms.

***

© 2024 [No Clocks, LLC](https://noclocks.dev)

0 comments on commit 1988447

Please sign in to comment.