diff --git a/workshop/content/docs/setup.md b/workshop/content/docs/setup.md index 8646c60..c9a072e 100644 --- a/workshop/content/docs/setup.md +++ b/workshop/content/docs/setup.md @@ -31,6 +31,8 @@ Having said this, please feel free to use what works for you :) Most exercises will focus on editing the pygeoapi [configuration](https://docs.pygeoapi.io/en/latest/configuration.html), which is in the [YAML](https://yaml.org) format. If you are not familiar with YAML, it is worth reading through a [tutorial](https://www.cloudbees.com/blog/yaml-tutorial-everything-you-need-get-started) to become aware of YAML syntax and indentation. +## Docker + The main requirement for the training is to install Docker and/with Docker Compose on your system. We strongly advise to install Docker before the workshop starts. @@ -42,8 +44,6 @@ Workshop Exercises will also be based on Docker, hence a custom installation wou The good news is that only a single installation (Docker) is needed! The Docker images used in this workshop contain the latest pygeoapi and all its dependencies and external services (e.g. PostGIS). -## About Docker - Docker has been available since 2013, and provided as a deployment option on numerous FOSS software and OSGeo projects. Given the current era of computing, chances are that you have heard of Docker and *containerization*. Or, perhaps are already familiar and hopefully using Docker already. If not, there is an abundance of introductory materials that can be found online like this [tutorial from IBM](https://www.ibm.com/topics/docker). @@ -61,7 +61,7 @@ Stepping up further are even more sophisticated Docker orchestrators like [Rancher](https://rancher.com/products/rancher) and [Kubernetes](https://kubernetes.io), but for this workshop, Docker and Docker Compose are all we need. -## Installation +### Installation Docker installation has greatly progressed over the years. This is the only part of the workshop which is dependent on the system/OS you are running (e.g. Windows, Mac or Linux). For each diff --git a/workshop/content/docs/setup.pt.md b/workshop/content/docs/setup.pt.md index 3778454..942c466 100644 --- a/workshop/content/docs/setup.pt.md +++ b/workshop/content/docs/setup.pt.md @@ -29,6 +29,8 @@ Dito isto, sinta-se à vontade para usar o que funciona melhor para si :) A maioria dos exercícios focar-se-á na edição da [configuração](https://docs.pygeoapi.io/en/latest/configuration.html) da pygeoapi, que está no formato [YAML](https://yaml.org). Se não estiver familiarizado com YAML, vale a pena ler um [tutorial](https://www.cloudbees.com/blog/yaml-tutorial-everything-you-need-get-started) para se familiarizar com a sintaxe e a indentação do YAML. +## Docker + O requisito principal para a formação é instalar o Docker e/ou o Docker Compose no seu sistema. Aconselhamos vivamente a instalação do Docker antes do início da workshop. @@ -37,8 +39,6 @@ Embora sejam possíveis vários cenários de instalação personalizada (consult Os Exercícios da Workshop também serão baseados no Docker, pelo que uma instalação personalizada seria, no mínimo, 'desafiadora'. A boa notícia é que apenas uma única instalação (Docker) é necessária! As imagens Docker utilizadas nesta workshop contêm a versão mais recente da pygeoapi e todas as suas dependências e serviços externos (ex: PostGIS). -## Sobre o Docker - O Docker está disponível desde 2013 e é fornecido como uma opção de implementação em inúmeros projetos de software FOSS e da OSGeo. Dada a era atual da computação, é provável que já tenha ouvido falar do Docker e de *contentorização*. Ou, talvez, já esteja familiarizado e, esperamos, já a utilizar o Docker. Se não for o caso, existe uma abundância de materiais introdutórios que podem ser encontrados online, como este [tutorial da IBM](https://www.ibm.com/topics/docker). @@ -48,7 +48,7 @@ O [Docker Compose](https://docs.docker.com/compose) é um complemento do Docker Num patamar superior, existem orquestradores Docker ainda mais sofisticados, como o [Rancher](https://rancher.com/products/rancher) e o [Kubernetes](https://kubernetes.io), mas para esta workshop, o Docker e o Docker Compose são tudo o que precisamos. -## Instalação +### Instalação A instalação do Docker progrediu muito ao longo dos anos. Esta é a única parte da workshop que depende do sistema/SO que está a utilizar (ex: Windows, Mac ou Linux). Para cada sistema, o site do Docker fornece instruções de instalação detalhadas. Por favor, siga-as de forma consistente.