Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update URLs to openveda.cloud and bump stac_ipyleaflet #27

Merged
merged 3 commits into from
Sep 5, 2024
Merged

Conversation

maxrjones
Copy link
Collaborator

@maxrjones maxrjones commented Aug 13, 2024

The endpoints have migrated, this PR updates the environment variables that contain those URLs. Also bumps stac_ipyleaflet so that the VEDA tutorials run successfully.

environment.yml Outdated Show resolved Hide resolved
@maxrjones maxrjones changed the title Update URLs to openveda.cloud Update URLs to openveda.cloud and bump stac_ipyleaflet Aug 13, 2024
- jupyter-sshd-proxy
- jupyterlab-bxplorer
variables:
TITILER_STAC_ENDPOINT: 'https://staging-stac.delta-backend.com'
TITILER_ENDPOINT: 'https://staging-raster.delta-backend.com'
TITILER_STAC_ENDPOINT: 'https://openveda.cloud/api/stac'

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This TITILER_STAC variable is odd. We used to have a /api/raster/stac endpoint but that's now deprecated and we have a different prefix. Wonder if it's supposed to refer to that endpoint or if its just looking for the stac catalog (i.e. /api/stac).

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The variables seem to be defined for use in stac_ipyleaflet. Looking at the references in the code base, here's an example of it's use: assets_endpoint = f"{self.titiler_stac_endpoint}/mosaicjson/{str_bounds}/assets?url={mosaic_url}/mosaicjson" where self.titiler_stac_endpoint is set using TITILER_STAC_ENDPOINT. Does that help provide info about what the variable should be set as? I could look more if not, I just don't have the available endpoints memorized at this point.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok this makes sense, thanks for providing that. So the old [raster_api]/stac endpoints should be updated to the new titiler-pgstac endpoints which follow this pattern -> /collections/{collection_id}/items/{item_id}
I think the assets example above would now be:
/collections/{collection_id}/items/{item_id}/assets

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you can see the new endpoints here: https://openveda.cloud/api/raster/docs

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I searched TITILER_STAC_ENDPOINT here in pangeo-notebook-veda-image and in veda-docs and couldn't find any usage.

The only case I can find is in stac_ipyleaflet where looks like MAAP uses it for one of their titilers https://github.com/MAAP-Project/stac_ipyleaflet/blob/main/README.md?plain=1#L60

@jjfrench @emmalu do you think veda can just use the default veda titiler here (openveda.cloud/api/raster)?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I meant to open an issue for this, but perhaps we could have the conversation here. Zooming out - what's the plan for https://github.com/MAAP-Project/stac_ipyleaflet? I think we could have some CI to ensure the VEDA tutorial always works if we plan to maintain the widget, but if the functionality is likely to be built into other tools instead (e.g., lonboard), it would likely be better to remove these env variables and the notebook from the VEDA docs.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TITILER_STAC_ENDPOINT comes from MAAP where titiler-stac.maap-project.org was a Titiler with the /stac endpoint - a bit dated now since these endpoints have moved.

We plan on removing titiler-stac.maap-project.org and consolidate our titilers, which would mean making changes to stac-ipyleaflet because the endpoints it uses are different/older. So @anayeaye , if this is setting the TITILER_STAC tiler to use for stac-ipyleaflet, I think that using openveda.cloud/api/raster likely wouldn't work with all functionalities because it's manually adding /stac and /cog onto the endpoints

Might be easiest to remove any tests using stac-ipyleaflet for now if you've already updated all of your titiler instances

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just dropping this semi-related issue so it is findable if needed MAAP-Project/stac_ipyleaflet#130

@batpad
Copy link
Collaborator

batpad commented Sep 5, 2024

Sorry for the delay merging this and thank you!

@batpad batpad merged commit 2832758 into main Sep 5, 2024
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants