diff --git a/LINUX.md b/LINUX.md index bf171ef..0687920 100644 --- a/LINUX.md +++ b/LINUX.md @@ -934,24 +934,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts) ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet. -- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey) -- Select your project in the list of recent projects if asked to -- Create a service account: - - Click on **CREATE SERVICE ACCOUNT**: - - Give a `Service account name` to that account - - Click on **CREATE AND CONTINUE** - - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources - - Click on **CONTINUE** - - Click on **DONE** -- Download the service account json file 🔑: - - Click on the newly created service account - - Click on **KEYS** - - Click on **ADD KEY** then **Create new key** - - Select **JSON** and click on **CREATE** - -![](images/gcp_create_key.png) - -The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`) +#### Go to the Service Accounts page + +Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey). + +- Select your project in the list of recent projects if asked to. +- If not asked, make sure the right project is selected in the Project selecter list at the top of the page. + +An alternate way to navigate to the Service Accounts page is from the following: + +01 Go to Service Accounts + +#### Create a service account + +- Click on **CREATE SERVICE ACCOUNT**. + + 02 Create Service Account + +- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**. + + 03 Name the service account + +- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project. + + 04 Add BigQuery Job User + +- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*. + + 04 Done + + +#### Create a json key 🔑 for this service account + +- On the service accounts page, click on the email address of the newly created service account. + + 05 Select the service account + +- Click on the **KEYS** tab at the top of the page. + + 06 Go to Keys + + +- Click on **ADD KEY** then **Create new key**. + + 07 Add Key + + +- Select **JSON** and click on **CREATE**. + + 08 Choose JSON and Create + +- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`). - Store the service account json file somewhere you'll remember, for example: diff --git a/WINDOWS.md b/WINDOWS.md index 35499e7..5085cad 100644 --- a/WINDOWS.md +++ b/WINDOWS.md @@ -1611,24 +1611,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts) ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet. -- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey) -- Select your project in the list of recent projects if asked to -- Create a service account: - - Click on **CREATE SERVICE ACCOUNT**: - - Give a `Service account name` to that account - - Click on **CREATE AND CONTINUE** - - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources - - Click on **CONTINUE** - - Click on **DONE** -- Download the service account json file 🔑: - - Click on the newly created service account - - Click on **KEYS** - - Click on **ADD KEY** then **Create new key** - - Select **JSON** and click on **CREATE** - -![](images/gcp_create_key.png) - -The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`) +#### Go to the Service Accounts page + +Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey). + +- Select your project in the list of recent projects if asked to. +- If not asked, make sure the right project is selected in the Project selecter list at the top of the page. + +An alternate way to navigate to the Service Accounts page is from the following: + +01 Go to Service Accounts + +#### Create a service account + +- Click on **CREATE SERVICE ACCOUNT**. + + 02 Create Service Account + +- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**. + + 03 Name the service account + +- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project. + + 04 Add BigQuery Job User + +- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*. + + 04 Done + + +#### Create a json key 🔑 for this service account + +- On the service accounts page, click on the email address of the newly created service account. + + 05 Select the service account + +- Click on the **KEYS** tab at the top of the page. + + 06 Go to Keys + + +- Click on **ADD KEY** then **Create new key**. + + 07 Add Key + + +- Select **JSON** and click on **CREATE**. + + 08 Choose JSON and Create + +- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`). We will now move the service account json file from your Windows disk to the Ubuntu disk. This will allow the development tools in Ubuntu to access to the resources of your GCP account. diff --git a/_partials/gcp_setup.md b/_partials/gcp_setup.md index 008431d..e88a60d 100644 --- a/_partials/gcp_setup.md +++ b/_partials/gcp_setup.md @@ -183,21 +183,54 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts) ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet. -- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey) -- Select your project in the list of recent projects if asked to -- Create a service account: - - Click on **CREATE SERVICE ACCOUNT**: - - Give a `Service account name` to that account - - Click on **CREATE AND CONTINUE** - - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources - - Click on **CONTINUE** - - Click on **DONE** -- Download the service account json file 🔑: - - Click on the newly created service account - - Click on **KEYS** - - Click on **ADD KEY** then **Create new key** - - Select **JSON** and click on **CREATE** - -![](images/gcp_create_key.png) - -The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`) +#### Go to the Service Accounts page + +Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey). + +- Select your project in the list of recent projects if asked to. +- If not asked, make sure the right project is selected in the Project selecter list at the top of the page. + +An alternate way to navigate to the Service Accounts page is from the following: + +01 Go to Service Accounts + +#### Create a service account + +- Click on **CREATE SERVICE ACCOUNT**. + + 02 Create Service Account + +- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**. + + 03 Name the service account + +- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project. + + 04 Add BigQuery Job User + +- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*. + + 04 Done + + +#### Create a json key 🔑 for this service account + +- On the service accounts page, click on the email address of the newly created service account. + + 05 Select the service account + +- Click on the **KEYS** tab at the top of the page. + + 06 Go to Keys + + +- Click on **ADD KEY** then **Create new key**. + + 07 Add Key + + +- Select **JSON** and click on **CREATE**. + + 08 Choose JSON and Create + +- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`). diff --git a/macOS.md b/macOS.md index 24fd61b..c9363a1 100644 --- a/macOS.md +++ b/macOS.md @@ -1040,24 +1040,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts) ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet. -- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey) -- Select your project in the list of recent projects if asked to -- Create a service account: - - Click on **CREATE SERVICE ACCOUNT**: - - Give a `Service account name` to that account - - Click on **CREATE AND CONTINUE** - - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources - - Click on **CONTINUE** - - Click on **DONE** -- Download the service account json file 🔑: - - Click on the newly created service account - - Click on **KEYS** - - Click on **ADD KEY** then **Create new key** - - Select **JSON** and click on **CREATE** - -![](images/gcp_create_key.png) - -The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`) +#### Go to the Service Accounts page + +Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey). + +- Select your project in the list of recent projects if asked to. +- If not asked, make sure the right project is selected in the Project selecter list at the top of the page. + +An alternate way to navigate to the Service Accounts page is from the following: + +01 Go to Service Accounts + +#### Create a service account + +- Click on **CREATE SERVICE ACCOUNT**. + + 02 Create Service Account + +- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**. + + 03 Name the service account + +- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project. + + 04 Add BigQuery Job User + +- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*. + + 04 Done + + +#### Create a json key 🔑 for this service account + +- On the service accounts page, click on the email address of the newly created service account. + + 05 Select the service account + +- Click on the **KEYS** tab at the top of the page. + + 06 Go to Keys + + +- Click on **ADD KEY** then **Create new key**. + + 07 Add Key + + +- Select **JSON** and click on **CREATE**. + + 08 Choose JSON and Create + +- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`). - Store the service account json file somewhere you'll remember, for example: