Skip to content

Commit

Permalink
Merge pull request #78 from developmentseed/develop
Browse files Browse the repository at this point in the history
2.0.0 final
  • Loading branch information
matthewhanson authored Oct 25, 2019
2 parents d45c445 + cb557a4 commit 4cbce50
Show file tree
Hide file tree
Showing 3 changed files with 38 additions and 30 deletions.
4 changes: 2 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
## [Unreleased]


## [v2.0.0rc1] - 2019-10-25
## [v2.0.0] - 2019-10-25

### Added
- Added OpenSSL, which is used to compile versions of Python 3.7+, it is not packaged in GeoLambda Layer
Expand Down Expand Up @@ -85,7 +85,7 @@ Package Versions
- GDAL_VERSION=2.3.1

[Unreleased]: https://github.com/sat-utils/sat-stac/compare/master...develop
[v2.0.0]: https://github.com/developmentseed/geolambda/compare/1.2.0...2.0.0rc1
[v2.0.0]: https://github.com/developmentseed/geolambda/compare/1.2.0...2.0.0
[v1.2.0]: https://github.com/developmentseed/geolambda/compare/1.1.0...1.2.0
[v1.1.0]: https://github.com/developmentseed/geolambda/compare/1.0.0...1.1.0
[v1.0.0]: https://github.com/developmentseed/geolambda/tree/1.0.0
62 changes: 35 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,47 +17,34 @@ While GeoLambda was initially intended for AWS Lambda it is also useful as a bas
| 1.2.0 | 2.4.2 | Separate Python (3.7.4) image and Lambda Layer added |
| 2.0.0 | 3.0.1 | libgeotiff 1.5.1, proj 6.2.0 |

### Docker images
#### Environment variables

The Docker images used to create the Lambda layer are also published to Docker Hub, and thus are also suitable for general use as a base image for geospatial applications.
When using GeoLambda some environment variables need to be set. These are set in the Docker image, but if using the Lambda Layer they will need to be set:

The developmentseed/geolambda image in Docker Hub is tagged by version.

$ docker pull developmentseed/geolambda:<version>
- GDAL_DATA=/opt/share/gdal
- PROJ_LIB=/opt/share/proj (only needed for GeoLambda 2.0.0+)

Or just include it in your own Dockerfile as the base image.
### Lambda Layers

```
FROM developmentseed/geolambda:<version>
```
If you just wish to use the publicly available Lambda layers you will need the ARN for the layer in the same region as your Lambda function. Currently, GeoLambda layers are available in `us-east-1`, `us-west-2`, and `eu-central-1`. If you want to use it in another region please file an issue or you can also create your own layer using this repository (see instructions below on 'Create a new version').

The GeoLambda image does not have an entrypoint defined, so a command must be provided when you run it. This example will mount the current directory to /work and run the container interactively.

$ docker run --rm -v $PWD:/home/geolambda -it developmentseed/geolambda:latest /bin/bash

All of the GDAL CLI tools are installed so could be run on images in the current directory.

### Lambda Layer

If you just wish to use the publicly available Lambda layer you will need the ARN for the layer in the same region as your Lambda function. Currently, GeoLambda layers are available in `us-east-1`, `us-west-2`, and `eu-central-1`. If you want to use it in another region please file an issue or you can also create your own layer using this repository (see instructions below on 'Create a new version').

#### v2.0.0rc1
#### v2.0.0

| Region | ARN |
| ------ | --- |
| us-east-1 | arn:aws:lambda:us-east-1:552188055668:layer:geolambda:3 |
| us-west-2 | arn:aws:lambda:us-west-2:552188055668:layer:geolambda:3 |
| eu-central-1 | arn:aws:lambda:eu-central-1:552188055668:layer:geolambda:3 |
| us-east-1 | arn:aws:lambda:us-east-1:552188055668:layer:geolambda:4 |
| us-west-2 | arn:aws:lambda:us-west-2:552188055668:layer:geolambda:4 |
| eu-central-1 | arn:aws:lambda:eu-central-1:552188055668:layer:geolambda:4 |

#### v2.0.0rc1-python
#### v2.0.0-python

See the [GeoLambda Python README](python/README.md). The Python Lambda Layer includes the libraries `numpy`, `rasterio`, `GDAL`, `pyproj`, and `shapely`.

| Region | ARN |
| ------ | --- |
| us-east-1 | arn:aws:lambda:us-east-1:552188055668:layer:geolambda-python:2 |
| us-west-2 | arn:aws:lambda:us-west-2:552188055668:layer:geolambda-python:2 |
| eu-central-1 | arn:aws:lambda:eu-central-1:552188055668:layer:geolambda-python:2 |
| us-east-1 | arn:aws:lambda:us-east-1:552188055668:layer:geolambda-python:3 |
| us-west-2 | arn:aws:lambda:us-west-2:552188055668:layer:geolambda-python:3 |
| eu-central-1 | arn:aws:lambda:eu-central-1:552188055668:layer:geolambda-python:3 |

#### v1.2.0

Expand Down Expand Up @@ -86,6 +73,27 @@ See the [GeoLambda Python README](python/README.md). The Python Lambda Layer inc
| eu-central-1 | arn:aws:lambda:eu-central-1:552188055668:layer:geolambda:1 |


### Docker images

The Docker images used to create the Lambda layer are also published to Docker Hub, and thus are also suitable for general use as a base image for geospatial applications.

The developmentseed/geolambda image in Docker Hub is tagged by version.

$ docker pull developmentseed/geolambda:<version>

Or just include it in your own Dockerfile as the base image.

```
FROM developmentseed/geolambda:<version>
```

The GeoLambda image does not have an entrypoint defined, so a command must be provided when you run it. This example will mount the current directory to /work and run the container interactively.

$ docker run --rm -v $PWD:/home/geolambda -it developmentseed/geolambda:latest /bin/bash

All of the GDAL CLI tools are installed so could be run on images in the current directory.


## Development

Contributions to the geolambda project are encouraged. The goal is to provide a turnkey method for developing and deploying geospatial applications to AWS. The 'master' branch in this repository contains the current state as deployed to the Docker Hub images `developmentseed/geolambda:latest` and `devlopmentseed/geolambda-python:latest`, along with a tag of the version. The 'develop' branch is the development version and is not deployed to Docker Hub.
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
2.0.0rc1
2.0.0

0 comments on commit 4cbce50

Please sign in to comment.