Skip to content

Commit

Permalink
Bump version for Bioc 3.19
Browse files Browse the repository at this point in the history
  • Loading branch information
bschilder committed Dec 21, 2023
1 parent d8a828a commit 891a6b6
Show file tree
Hide file tree
Showing 4 changed files with 50 additions and 27 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/rworkflows.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ jobs:
bioc: devel
r: auto
cont: ghcr.io/bioconductor/bioconductor_docker:devel
rspm: https://packagemanager.rstudio.com/cran/__linux__/latest/release
rspm: ~
- os: macOS-latest
bioc: release
r: auto
Expand Down
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Package: orthogene
Type: Package
Title: Interspecies gene mapping
Version: 1.7.3
Version: 1.9.1
Authors@R:
c(
person(given = "Brian",
Expand Down
7 changes: 7 additions & 0 deletions NEWS.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
# orthogene 1.9.1

## New features

* Bump version for Bioc 3.19.
* Use GHCR instead of Dockerhub, update vignette accordingly.

# orthogene 1.7.3

## New features
Expand Down
66 changes: 41 additions & 25 deletions vignettes/docker.Rmd
Original file line number Diff line number Diff line change
@@ -1,35 +1,50 @@
---
title: "Docker/Singularity Containers"
author: "<h4>Authors: <i>`r auths <- eval(parse(text = gsub('person','c',read.dcf('../DESCRIPTION', fields = 'Authors@R'))));paste(auths[names(auths)=='given'],auths[names(auths)=='family'], collapse = ', ')`</i></h4>"
date: "<h4>Vignette updated: <i>`r format( Sys.Date(), '%b-%d-%Y')`</i></h4>"
title: Docker/Singularity Containers
author: '<h4>Authors: <i>`r auths <- eval(parse(text = gsub("person","c",read.dcf("../DESCRIPTION",
fields = "Authors@R"))));paste(auths[names(auths)=="given"],auths[names(auths)=="family"],
collapse = ", ")`</i></h4>'
date: '<h4>Vignette updated: <i>`r format( Sys.Date(), "%b-%d-%Y")`</i></h4>'
output:
BiocStyle::html_document:
vignette: >
%\VignetteIndexEntry{docker}
%\usepackage[utf8]{inputenc}
%\VignetteEngine{knitr::rmarkdown}
BiocStyle::html_document:
md_extensions: -autolink_bare_uris
params:
cont:
value: ghcr.io/neurogenomics/orthogene
docker_registry:
value: ghcr.io
docker_org:
value: neurogenomics
vignette: |
%\VignetteIndexEntry{docker}
%\usepackage[utf8]{inputenc}
%\VignetteEngine{knitr::rmarkdown}
---


```{r setup, include=FALSE}
#### Package name ####
pkg <- read.dcf("../DESCRIPTION", fields = "Package")[1]
library(pkg, character.only = TRUE)
PKG <- read.dcf("../DESCRIPTION", fields = "Package")[1]
library(PKG, character.only = TRUE)
## Docker containers must be lowercase
pkg <- tolower(pkg)
pkg <- tolower(PKG)
#### Username of DockerHub account ####
docker_user <- "neurogenomicslab"
docker_org <- params$docker_org
docker_registry <- params$docker_registry
cont <- params$cont
docker_url <- if(grepl("ghcr.io",docker_registry)){
paste("https://ghcr.io",cont,sep="/")
} else {
paste("https://hub.docker.com/repository/docker",docker_org,pkg,sep="/")
}
```

# DockerHub
# Installation

`r pkg` is now available via
[DockerHub](https://hub.docker.com/repository/docker/`r docker_user`/`r pkg`)
`r PKG` is now available via [`r docker_registry`](`r docker_url`)
as a containerised environment with Rstudio and
all necessary dependencies pre-installed.

## Installation

## Method 1: via Docker

First, [install Docker](https://docs.docker.com/get-docker/)
Expand All @@ -39,7 +54,7 @@ Create an image of the [Docker](https://www.docker.com/) container
in command line:

```
docker pull `r docker_user`/`r pkg`
docker pull `r cont`
```

Once the image has been created, you can launch it with:
Expand All @@ -51,8 +66,8 @@ docker run \
-e PASSWORD="<your_password>" \
-v ~/Desktop:/Desktop \
-v /Volumes:/Volumes \
-p 8787:8787 \
`r docker_user`/`r pkg`
-p 8900:8787 \
`r cont`
```

### NOTES
Expand All @@ -62,25 +77,26 @@ docker run \
* The `-d` ensures the container will run in "detached" mode,
which means it will persist even after you've closed your command line session.
* The username will be *"rstudio"* by default.
* Optionally, you can also install the [Docker Desktop](https://www.docker.com/products/docker-desktop)
* Optionally, you can also install the [Docker Desktop](https://www.docker.com/products/docker-desktop/)
to easily manage your containers.

## Method 2: via Singularity

If you are using a system that does not allow Docker
(as is the case for many institutional computing clusters),
you can instead [install Docker images via Singularity](https://sylabs.io/guides/2.6/user-guide/singularity_and_docker.html).
you can instead [install Docker images via Singularity](https://docs.sylabs.io/guides/2.6/user-guide/singularity_and_docker.html).

```
singularity pull docker://`r docker_user`/`r pkg`
singularity pull docker://`r cont`
```

For troubleshooting, see the [Singularity documentation](https://docs.sylabs.io/guides/latest/user-guide/singularity_and_docker.html#github-container-registry).

## Usage
# Usage

Finally, launch the containerised Rstudio by entering the
following URL in any web browser:
*http://localhost:8787/*
*http://localhost:8900/*

Login using the credentials set during the Installation steps.

Expand Down

0 comments on commit 891a6b6

Please sign in to comment.