earthlab/earth-analytics-python-env

Earth Analytics Python Conda环境

欢迎使用Earth Analytics Python环境仓库！这里提供了可通过.yaml文件在本地安装的Conda环境，以及可在容器化环境中运行该环境的Docker镜像。

贡献者

• Leah A. Wasser (@lwasser)
• Filipe fernandes (@ocefpaf)
• Tim Head (@betatim)
• Chris Holdgraf (@choldgraf)
• Max Joseph (@mbjoseph)
• Martha Morrissey

Conda环境入门

1. 在本地计算机安装Earth Lab Conda环境

首先，安装适用于Python 3.x（建议3.6版本）的git和conda。

• 安装git：https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
• 安装miniconda：https://docs.conda.io/en/latest/miniconda.html
• 关于Conda环境：https://conda.io/docs/user-guide/tasks/manage-environments.html

设置教程

如需更详细的使用miniconda设置此环境的教程，请访问我们的学习门户：[***]

我们建议使用conda-forge通道安装所有包。

快速开始：设置环境

上述教程提供了更详细的设置说明，以下是简要步骤：

首先，使用以下命令安装环境：

bash
conda env create -f environment.yml

此过程需要一些时间。

• 注意：上述命令需在environment.yml文件所在目录中运行，请先切换到该目录：

bash
cd earth-analytics-python-env

从YAML文件更新EA环境

您可以随时使用以下命令更新环境：

bash
conda env update -f environment.yml

要管理conda环境，请使用以下命令：

查看已安装的环境

bash
conda info --envs

激活要使用的环境

https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html%EF%BC%9A

bash
conda activate earth-analytics-python

环境名称为earth-analytics-python，在environment.yml文件中定义。

Docker构建

要运行Docker容器，请执行以下步骤：

1. https://docs.docker.com/install/%E5%B9%B6%E7%A1%AE%E4%BF%9D%E5%85%B6%E6%AD%A3%E5%9C%A8%E8%BF%90%E8%A1%8C%E3%80%82

2. 在本地计算机上构建Docker镜像。请耐心等待，此过程需要一些时间。运行以下命令在本地构建Docker镜像：

bash
cd earth-analytics-python-env
docker build -t earthlab/earth-analytics-python-env .
docker run -it -p 8888:8888 docker.xuanyuan.run/earthlab/earth-analytics-python-env

3. 运行镜像

要运行earth-analytics镜像，请使用以下命令：

bash
docker run --hostname localhost -it -p 8888:8888 docker.xuanyuan.run/earthlab/earth-analytics-python-env

注意：earthlab/earth-analytics-python-env是上述构建的镜像名称。要查看计算机上的所有镜像，请输入：

bash
docker images --all

运行镜像后，命令行会提供一个URL。将该URL粘贴到浏览器中，即可运行安装了earth analytics环境的Jupyter！

更新Earth Analytics环境

如果您希望更新earth analytics环境，请执行以下步骤：

1. 提交包含更改的PR到master分支
2. 代码管理员将PR合并到master分支
3. 检查并等待https://hub.docker.com/r/earthlab/earth-analytics-python-env/tags/%E4%B8%BA%E5%90%88%E5%B9%B6%E7%9A%84PR%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%9C%A8https://hub.docker.com/r/earthlab/earth-analytics-python-env/builds/%E6%9F%A5%E7%9C%8B%E6%9E%84%E5%BB%BA%E8%BF%9B%E5%BA%A6