diff --git a/docs/source/_images/setup/gee/sepal_select_gcp.png b/docs/source/_images/setup/gee/sepal_select_gcp.png new file mode 100644 index 0000000000..29df970de7 Binary files /dev/null and b/docs/source/_images/setup/gee/sepal_select_gcp.png differ diff --git a/docs/source/_images/setup/register/confirm_gcp_info.png b/docs/source/_images/setup/register/confirm_gcp_info.png new file mode 100644 index 0000000000..c71ee632d7 Binary files /dev/null and b/docs/source/_images/setup/register/confirm_gcp_info.png differ diff --git a/docs/source/_images/setup/register/create_gcp_to_register.png b/docs/source/_images/setup/register/create_gcp_to_register.png new file mode 100644 index 0000000000..315d398aa2 Binary files /dev/null and b/docs/source/_images/setup/register/create_gcp_to_register.png differ diff --git a/docs/source/_images/setup/register/gcp_terms_of_service.png b/docs/source/_images/setup/register/gcp_terms_of_service.png new file mode 100644 index 0000000000..9ca5e9624f Binary files /dev/null and b/docs/source/_images/setup/register/gcp_terms_of_service.png differ diff --git a/docs/source/_images/setup/register/gee_gcp_declaration.png b/docs/source/_images/setup/register/gee_gcp_declaration.png index bb92f1a7a5..2670c96abb 100644 Binary files a/docs/source/_images/setup/register/gee_gcp_declaration.png and b/docs/source/_images/setup/register/gee_gcp_declaration.png differ diff --git a/docs/source/_images/setup/register/gee_gcp_type.png b/docs/source/_images/setup/register/gee_gcp_type.png new file mode 100644 index 0000000000..8bd0566776 Binary files /dev/null and b/docs/source/_images/setup/register/gee_gcp_type.png differ diff --git a/docs/source/_images/setup/register/gee_gcp_type2.png b/docs/source/_images/setup/register/gee_gcp_type2.png new file mode 100644 index 0000000000..50186556f6 Binary files /dev/null and b/docs/source/_images/setup/register/gee_gcp_type2.png differ diff --git a/docs/source/_images/setup/register/gee_landing.png b/docs/source/_images/setup/register/gee_landing.png index 16a7ce2a40..ed35199bf5 100644 Binary files a/docs/source/_images/setup/register/gee_landing.png and b/docs/source/_images/setup/register/gee_landing.png differ diff --git a/docs/source/_images/setup/register/select_gcp_sepal.png b/docs/source/_images/setup/register/select_gcp_sepal.png new file mode 100644 index 0000000000..a8a9021a66 Binary files /dev/null and b/docs/source/_images/setup/register/select_gcp_sepal.png differ diff --git a/docs/source/setup/create_github.rst b/docs/source/setup/create_github.rst new file mode 100644 index 0000000000..7e70f90230 --- /dev/null +++ b/docs/source/setup/create_github.rst @@ -0,0 +1,4 @@ +Create a GitHub account +*********************** + +GitHub is useful for developers because it allows them to share their code and collaborate on projects with other developers while keeping track of changes to their code. diff --git a/docs/source/setup/gee.rst b/docs/source/setup/gee.rst index 69c21ed6bf..1897ae9c44 100644 --- a/docs/source/setup/gee.rst +++ b/docs/source/setup/gee.rst @@ -36,38 +36,59 @@ Sign up A GEE account is required to properly export images and data products as GEE assets or SEPAL applications using GEE from the SEPAL interface. A Google account is required to sign up for GEE. -To sign up for a Google account, go to https://accounts.google.com/servicelogin. +To sign up for a Google account, go to https://code.earthengine.google.com and select **I want to register a new project**. -To request a GEE account, go to https://earthengine.google.com/new_signup. .. thumbnail:: ../_images/setup/register/gee_landing.png - :title: Request access to GEE. + :title: Request access to GEE :align: center -For first-time users of SEPAL, select **Use without a cloud project** (for non-commercial users of GEE; the link between GEE and Google Cloud Projects [GCPs] is evolving and SEPAL will continue to develop in order to make use of GCPs correctly – but for now, use SEPAL without a GCP). +.. _create-gcp: + +Create a Google Cloud project +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +GEE now requires connecting to a Google Cloud project (GCP), available for paid commercial use or free for academic and research purposes. + +1. Select **Register a Noncomercial or Commercial Cloud project** and follow the instructions to create your account. .. thumbnail:: ../_images/setup/register/gee_gcp_declaration.png - :title: Use GEE without a cloud project. + :title: Get started using Earth Engine :align: center + :width: 75% -Once you have a GEE account, access the **Earth Engine Code Editor** by going to https://code.earthengine.google.com. +2. Select **Unpaid usage** and choose your project type (e.g. Academia & Research, Government, Non-profit). Select **Next**. -.. thumbnail:: ../_images/setup/register/gee_code.png - :title: GEE Code Editor +.. thumbnail:: ../_images/setup/register/gee_gcp_type2.png + :title: Select type of project :align: center + :width: 60% -.. tip:: +3. Create or choose an existing GCP to register your project, then select a **Project-id** and optionally a **Project name**. Select **Continue to summary**. + +4. A red alert will appear at the bottom of the page, requesting that you accept the **Cloud Terms of Service** to continue. Select the link. + +.. thumbnail:: ../_images/setup/register/create_gcp_to_register.png + :title: Create or choose a Cloud project to register + :align: center + :width: 60% - When you first connect to **Earth Engine Code Editor**, the SEPAL team recommends taking the tour of its features provided in the interface. +5. You will be redirected to the `Google Cloud `_ page, where you will see a welcome form. Read and accept the **Terms of Service** (**1**) and *optionally* (**2**) check the box for **Email updates**. Select **Agree and continue** (**3**). - .. thumbnail:: ../_images/setup/gee/editor_tour.png - :title: GEE Code Editor tour - :align: center - :width: 40% +.. thumbnail:: ../_images/setup/register/gcp_terms_of_service.png + :title: Create or choose a Cloud project to register + :align: center + +6. Finally, review the summary of your project and select **Confirm**. Your project is now registered and you can start using GEE. + +.. thumbnail:: ../_images/setup/register/confirm_gcp_info.png + :title: Confirm GCP information + :align: center + :width: 60% .. tip:: - If you experience trouble while linking your Google account to GEE, `ask the Google Group `__. + If you experience trouble while linking your Google account to GEE, `ask the Google Group community for support `__. Initialize the **Home** folder ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -163,7 +184,14 @@ Connection You will see a message requesting your permission to authorize SEPAL's access to your Google Drive, as well as your **Assets** folder and **Home** folder to export recipes and module results. -6. After the connection process is complete, you will be redirected to the SEPAL website. If you open **User details** again, the pop-up window will display *Connected* in green in the upper-right corner. +6. Once the connection process is complete, you will be redirected to the SEPAL website, where you can select the **Google Cloud project** you want to use with SEPAL (check :ref:`create-gcp`). Select **Apply**. + +.. thumbnail:: ../_images/setup/gee/sepal_select_gcp.png + :title: SEPAL and GEE connected + :align: center + :width: 40% + +7. Open **User details** again. The pop-up window should display **Connected** in green in the upper-right corner. .. thumbnail:: ../_images/setup/gee/user_interface_connected.png :title: SEPAL and GEE connected