From e34f960d53766385eff98a3798256e747868aa4d Mon Sep 17 00:00:00 2001 From: teresalves Date: Sun, 4 Aug 2024 22:19:30 +0100 Subject: [PATCH] feat: add aboutme page and kubernetes guide --- config/_default/hugo.toml | 3 +- config/_default/menus/menus.en.toml | 13 +- config/_default/params.toml | 8 +- content/aboutme/_index.md | 15 + .../guides => aboutme/aboutme}/_index.md | 2 +- content/aboutme/aboutme/summary.md | 51 ++ content/aboutme/events/_index.md | 15 + content/aboutme/events/summary.md | 27 + content/aboutme/resources.md | 17 + content/docs/guides/example.md | 21 - content/docs/kubernetes/_index.md | 15 + content/docs/kubernetes/example.md | 95 ++++ content/docs/reference/example.md | 4 +- hugo_stats.json | 22 + public/404.html | 13 +- public/aboutme/aboutme/index.html | 359 +++++++++++++ public/aboutme/aboutme/index.xml | 20 + .../aboutme/aboutme/quick-summary/index.html | 486 +++++++++++++++++ .../guides => aboutme/aboutme}/sitemap.xml | 2 +- public/aboutme/events/index.html | 359 +++++++++++++ public/aboutme/events/index.xml | 20 + .../events/public-speaking-events/index.html | 450 ++++++++++++++++ public/aboutme/events/sitemap.xml | 10 + public/aboutme/index.html | 364 +++++++++++++ public/aboutme/index.xml | 20 + .../resources}/index.html | 121 ++--- public/aboutme/sitemap.xml | 36 ++ public/blog/example-post/index.html | 13 +- public/blog/index.html | 15 +- public/blog/index.xml | 4 +- public/categories/index.html | 15 +- public/categories/index.xml | 4 +- public/contributors/index.html | 15 +- public/contributors/index.xml | 4 +- public/docs/guides/index.xml | 20 - public/docs/index.html | 25 +- public/docs/index.xml | 4 +- .../docs/kubernetes/basic-commands/index.html | 500 ++++++++++++++++++ public/docs/{guides => kubernetes}/index.html | 33 +- public/docs/kubernetes/index.xml | 20 + public/docs/kubernetes/sitemap.xml | 10 + .../index.html | 47 +- public/docs/reference/index.html | 23 +- public/docs/reference/index.xml | 10 +- public/docs/reference/sitemap.xml | 2 +- public/docs/resources/index.html | 27 +- public/docs/sitemap.xml | 6 +- public/index.html | 15 +- public/index.xml | 39 +- public/manifest.webmanifest | 4 +- public/privacy/index.html | 13 +- public/search-index.json | 2 +- public/sitemap.xml | 36 +- public/tags/index.html | 15 +- public/tags/index.xml | 4 +- 55 files changed, 3218 insertions(+), 275 deletions(-) create mode 100644 content/aboutme/_index.md rename content/{docs/guides => aboutme/aboutme}/_index.md (90%) create mode 100644 content/aboutme/aboutme/summary.md create mode 100644 content/aboutme/events/_index.md create mode 100644 content/aboutme/events/summary.md create mode 100644 content/aboutme/resources.md delete mode 100644 content/docs/guides/example.md create mode 100644 content/docs/kubernetes/_index.md create mode 100644 content/docs/kubernetes/example.md create mode 100644 public/aboutme/aboutme/index.html create mode 100644 public/aboutme/aboutme/index.xml create mode 100644 public/aboutme/aboutme/quick-summary/index.html rename public/{docs/guides => aboutme/aboutme}/sitemap.xml (80%) create mode 100644 public/aboutme/events/index.html create mode 100644 public/aboutme/events/index.xml create mode 100644 public/aboutme/events/public-speaking-events/index.html create mode 100644 public/aboutme/events/sitemap.xml create mode 100644 public/aboutme/index.html create mode 100644 public/aboutme/index.xml rename public/{docs/guides/example-guide => aboutme/resources}/index.html (80%) create mode 100644 public/aboutme/sitemap.xml delete mode 100644 public/docs/guides/index.xml create mode 100644 public/docs/kubernetes/basic-commands/index.html rename public/docs/{guides => kubernetes}/index.html (89%) create mode 100644 public/docs/kubernetes/index.xml create mode 100644 public/docs/kubernetes/sitemap.xml rename public/docs/reference/{example-reference => basic-commands}/index.html (89%) diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml index 6c270a76..d4665dba 100644 --- a/config/_default/hugo.toml +++ b/config/_default/hugo.toml @@ -1,4 +1,4 @@ -title = "My Docs" +title = "Teresa Alves" baseurl = "http://localhost/" canonifyURLs = false disableAliases = true @@ -59,6 +59,7 @@ copyRight = "Copyright (c) 2020-2024 Hyas" [permalinks] blog = "/blog/:slug/" docs = "/docs/:sections[1:]/:slug/" + aboutme = "/aboutme/:sections[1:]/:slug/" # docs = "/docs/1.0/:sections[1:]/:slug/" [minify.tdewolff.html] diff --git a/config/_default/menus/menus.en.toml b/config/_default/menus/menus.en.toml index 798bedb9..48e1922a 100644 --- a/config/_default/menus/menus.en.toml +++ b/config/_default/menus/menus.en.toml @@ -30,7 +30,7 @@ [[main]] name = "Docs" - url = "/docs/guides/example-guide/" + url = "/docs/kubernetes/basic-commands/" # url = "/docs/1.0/prologue/introduction/" weight = 10 @@ -39,12 +39,17 @@ url = "/blog/" weight = 30 +[[main]] + name = "About Me" + url = "/aboutme/aboutme/quick-summary/" + weight = 5 + # [[social]] # name = "Twitter" # pre = '' # url = "https://twitter.com/getdoks" # weight = 10 -# +# # [[social]] # name = "Discord" # pre = '' @@ -62,12 +67,12 @@ # name = "Guides" # pageRef = "/docs/guides" # weight = 10 -# +# # [[sidebar_docs]] # name = "Reference" # pageRef = "/docs/reference" # weight = 20 -# +# # [[sidebar_docs]] # name = "Resources" # pageRef = "/docs/resources" diff --git a/config/_default/params.toml b/config/_default/params.toml index 69801081..42881566 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -1,10 +1,10 @@ # Hugo -title = "My Docs" +title = "Teresa Alves" description = "Congrats on setting up a new Doks project!" images = ["cover.png"] # mainSections -mainSections = ["docs"] +mainSections = ["docs", "aboutme"] [social] twitter = "getdoks" @@ -44,7 +44,7 @@ mainSections = ["docs"] bootstrapJavascript = false # false (default) or true # Nav - sectionNav = ["docs"] # ["docs"] (default) or list of sections (e.g. ["docs", "guides"]) + sectionNav = ["docs", "aboutme"] # ["docs"] (default) or list of sections (e.g. ["docs", "guides"]) toTopButton = false # false (default) or true breadcrumbTrail = false # false (default) or true headlineHash = true # true (default) or false @@ -104,7 +104,7 @@ mainSections = ["docs"] [hyas_images] [hyas_images.defaults] decoding = "async" # sync, async, or auto (default) - fetchpriority = "auto" # high, low, or auto (default) + fetchpriority = "auto" # high, low, or auto (default) loading = "lazy" # eager or lazy (default) widths = [480, 576, 768, 1025, 1200, 1440] # [640, 768, 1024, 1366, 1600, 1920] for example sizes = "auto" # 100vw (default), 75vw, or auto for example diff --git a/content/aboutme/_index.md b/content/aboutme/_index.md new file mode 100644 index 00000000..afc39df9 --- /dev/null +++ b/content/aboutme/_index.md @@ -0,0 +1,15 @@ +--- +title: "Docs" +description: "" +summary: "" +date: 2023-09-07T16:12:03+02:00 +lastmod: 2023-09-07T16:12:03+02:00 +draft: false +weight: 999 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- diff --git a/content/docs/guides/_index.md b/content/aboutme/aboutme/_index.md similarity index 90% rename from content/docs/guides/_index.md rename to content/aboutme/aboutme/_index.md index 4e11d962..5fec8d58 100644 --- a/content/docs/guides/_index.md +++ b/content/aboutme/aboutme/_index.md @@ -1,5 +1,5 @@ --- -title: "Guides" +title: "About me" description: "" summary: "" date: 2023-09-07T16:06:50+02:00 diff --git a/content/aboutme/aboutme/summary.md b/content/aboutme/aboutme/summary.md new file mode 100644 index 00000000..6bde624b --- /dev/null +++ b/content/aboutme/aboutme/summary.md @@ -0,0 +1,51 @@ +--- +title: "Quick Summary" +description: "Introduction to me" +summary: "" +date: 2023-09-07T16:04:48+02:00 +lastmod: 2023-09-07T16:04:48+02:00 +draft: false +weight: 810 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- +## Introduction + +Hello and welcome! +I am Teresa Alves, a Software Engineer from Portugal 🇵🇹 +I have a background in Control and Automation (aka Math and Robots) and I have professional experience as a backend, platform and systems engineer. + +I am also a volunteer for [As Raparigas do Código](https://raparigasdocodigo.pt/), a volunteer organization focused including women in the tech world, and to get young childrens interested in technology. + +This website will share my quick guides to certain technologies, that will help me not forget things, and might help you learn them. + +Feel free to add me on [LinkedIn](https://www.linkedin.com/in/teresalves/)! + +## Need help with life? + +If you need help with things, I can help with the following technical things: +- basics of programming; +- what is backend, frontend, devops?; +- setting up your first API +- mock technical interviews; +- System design; +- Observability; +- Other platform related things (feel free to ask); + + +Non technical stuff: +- Starting a career in tech; +- building a CV; +- how to show confidence in interviews; +- how to deal with anxious dogs; + +Feel free to contact me on LinkedIn with any questions + +## Can I contribute? + +These notes represent things I know or have studied so I don't really want external contributions for whole new modules. However, feel free to add new issues in this repo for doc requests or propose fixes for somethign I already have that seems incorrect or incomplete! + diff --git a/content/aboutme/events/_index.md b/content/aboutme/events/_index.md new file mode 100644 index 00000000..5fec8d58 --- /dev/null +++ b/content/aboutme/events/_index.md @@ -0,0 +1,15 @@ +--- +title: "About me" +description: "" +summary: "" +date: 2023-09-07T16:06:50+02:00 +lastmod: 2023-09-07T16:06:50+02:00 +draft: false +weight: 800 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- diff --git a/content/aboutme/events/summary.md b/content/aboutme/events/summary.md new file mode 100644 index 00000000..438c8cac --- /dev/null +++ b/content/aboutme/events/summary.md @@ -0,0 +1,27 @@ +--- +title: "Public Speaking Events" +description: "Public Speaking and stuff" +summary: "" +date: 2023-09-07T16:04:48+02:00 +lastmod: 2023-09-07T16:04:48+02:00 +draft: false +weight: 810 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- +### Diversity and Inclusion in the tech world +###### 27/06/2024 + +I was a guest in an event for Career Management in Tech where I spoke about the importance of diversity and inclusion in the workplace, as a representative of [As Raparigas do Código](https://raparigasdocodigo.pt/). + +I believe that diversity is important for innovation and to achieve the best solutions. However, we do not currently have enough women in tech to have a 50/50 distribution of men and women in these roles. Because of that, we strive to have more girls interested in the area and we want to make sure that the women (and the other tech minorities) that are already in here feel included and have their voices heard. Being empathetic, respectful and inclusive to your coworkers is much more important than hitting quotas. This last part will come eventually, if the overall environment is pleasant and accepting. + +You can read the summary of the discussion and listen to the whole thing [here](https://visao.pt/exame/2024-06-27-diversidade-e-quotas-podemos-estar-a-ir-a-um-extremo-para-tentar-encontrar-um-meio/) (in Portuguese). + + + + diff --git a/content/aboutme/resources.md b/content/aboutme/resources.md new file mode 100644 index 00000000..8d1e452c --- /dev/null +++ b/content/aboutme/resources.md @@ -0,0 +1,17 @@ +--- +title: "Resources" +description: "" +summary: "" +date: 2024-02-27T09:30:56+01:00 +lastmod: 2024-02-27T09:30:56+01:00 +draft: false +weight: 999 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- + +Link to valuable, relevant resources. diff --git a/content/docs/guides/example.md b/content/docs/guides/example.md deleted file mode 100644 index 96d01211..00000000 --- a/content/docs/guides/example.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: "Example Guide" -description: "Guides lead a user through a specific task they want to accomplish, often with a sequence of steps." -summary: "" -date: 2023-09-07T16:04:48+02:00 -lastmod: 2023-09-07T16:04:48+02:00 -draft: false -weight: 810 -toc: true -seo: - title: "" # custom title (optional) - description: "" # custom description (recommended) - canonical: "" # custom canonical URL (optional) - noindex: false # false (default) or true ---- - -Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do. - -## Further reading - -- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework diff --git a/content/docs/kubernetes/_index.md b/content/docs/kubernetes/_index.md new file mode 100644 index 00000000..079bbc8c --- /dev/null +++ b/content/docs/kubernetes/_index.md @@ -0,0 +1,15 @@ +--- +title: "Kubernetes" +description: "" +summary: "" +date: 2023-09-07T16:06:50+02:00 +lastmod: 2023-09-07T16:06:50+02:00 +draft: false +weight: 800 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- diff --git a/content/docs/kubernetes/example.md b/content/docs/kubernetes/example.md new file mode 100644 index 00000000..6517d5c4 --- /dev/null +++ b/content/docs/kubernetes/example.md @@ -0,0 +1,95 @@ +--- +title: "Basic Commands" +description: "Guides lead a user through a specific task they want to accomplish, often with a sequence of steps." +summary: "" +date: 2023-09-07T16:04:48+02:00 +lastmod: 2023-09-07T16:04:48+02:00 +draft: false +weight: 810 +toc: true +seo: + title: "" # custom title (optional) + description: "" # custom description (recommended) + canonical: "" # custom canonical URL (optional) + noindex: false # false (default) or true +--- + +## Baseline commands + +`kubectl get pods` - check if the pods are starting correctly. You can add `| grep -c ` to count how many pods you have at a current time. You can also filter by label: \ +`kubectl get pods -l 'labelname=labelvalue'` + +`kubectl get deploy -o wide` - tells you which version it is getting from the repo, so you can be sure that you are deploying to the correct one. You can also check how many replicas are updated. + +`kubectl get configmap ` (or `kubectl get cm` for lazy people like me) - check the config maps that exist. BUT they all already exist basically, so what you usually want to check is what’s inside them with: \ +`kubectl describe cm `. + +Note that if you update the configmap, the values read by the pod don’t change automatically. The cm are read at the beginning of the deploy so in order to have it read you need to restart the pods. + +`kubectl get quota` - if you see your pods are not starting and your deployment is stuck, it might be because you ran out of quota. You can also check errors in the events + + +## Getting logs and events + +If you need to check events: + +`kubectl get events --sort-by='.metadata.creationTimestamp'` + +And now logs: + +`kubectl get logs -f ` + +Or for pods that have been restarted: + +`kubectl get logs —previous` + + +## Creating Secrets + +Secrets are objects that generally contain sensitive information, such as tokens or secrets. They behave similarly to a configmap but they are used only for sensitive information, so it’s not hardcoded in the application code. + +Each secret can have several keys, and therefore, several passwords or other pieces of information. You can therefore have a secret called `credentials` where inside you have two keys `password` and `user` with each respective value. Don’t forget that when reading a secret in your pod.yaml configs you need to specify both the secret name and the key from which you need the value: + +``` +- name: ENV_VAR_NAME + valueFrom: + secretKeyRef: + name: secret_name + key: password # or whatever your key is +``` + + +## Reading secrets: + +`kubectl edit secret ` and you can see the secret value there (but don’t edit it!) + +but it will show you the secret info and the value encoded in base64. To read it back you must do: + +`kubectl get secret "--template={{.data.password}}" | base64 --decode` + +Note that if you do want to edit it like that, you need to convert it to base64 before that. + +## Accessing other services: +From inside the cluster: + +`curl .:` + +If the service you are trying to access is in the namespace as your pod currently is, then you can omit the namespace name and just do\ +`:` + +Or just use the internal ingress associated with the service. Get it with: + +`kubectl get ingress` + +## Going inside the pod + +`kubectl exec -it bash` → if you have only one container in your pod, it will go inside that container. Otherwise, you will have to specify which container in that pod you are trying to access by using `-c `. + +`printenv` - run this command while inside the container to print all the environment variables that this is reading. It is particularly useful to verify if the config map and secrets are being correctly read in the pod. + +`ping ` or `curl ` - some services are not accessible through your local machine, but only inside the cluster. You can run this inside a pod. + +## Requesting without an ingress + +`kubectl port-forward ` - useful to do testing curls from your local machine + diff --git a/content/docs/reference/example.md b/content/docs/reference/example.md index 4cc712d3..735cbf02 100644 --- a/content/docs/reference/example.md +++ b/content/docs/reference/example.md @@ -1,6 +1,6 @@ --- -title: "Example Reference" -description: "Reference pages are ideal for outlining how things work in terse and clear terms." +title: "Basic Commands" +description: "Basic Guide for common commands that are not all in common guides" summary: "" date: 2023-09-07T16:13:18+02:00 lastmod: 2023-09-07T16:13:18+02:00 diff --git a/hugo_stats.json b/hugo_stats.json index 4b9a90e3..738a6464 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -6,11 +6,14 @@ "aside", "base", "body", + "br", "button", "circle", "code", "details", "div", + "figcaption", + "figure", "footer", "form", "g", @@ -18,6 +21,7 @@ "h2", "h3", "h5", + "h6", "head", "header", "html", @@ -33,6 +37,7 @@ "noscript", "p", "path", + "pre", "script", "section", "small", @@ -48,6 +53,7 @@ ], "classes": [ "DocSearch-Label", + "aboutme", "active", "anchor", "bg-dots", @@ -95,6 +101,7 @@ "docs-toc", "doks-sidebar", "error404", + "expressive-code", "flex-column", "flex-grow-1", "flex-lg-row", @@ -105,11 +112,13 @@ "footer", "form-control", "form-control-lg", + "frame", "fs-5", "h-auto", "h3", "h4", "h5", + "header", "home", "icon", "icon-tabler", @@ -166,6 +175,7 @@ "navbar-brand", "navbar-expand-lg", "navbar-nav", + "not-content", "offcanvas", "offcanvas-body", "offcanvas-end", @@ -225,15 +235,27 @@ "wrap" ], "ids": [ + "27062024", "TableOfContents", + "accessing-other-services", + "baseline-commands", "buttonColorMode", + "can-i-contribute", + "creating-secrets", + "diversity-and-inclusion-in-the-tech-world", "doks-docs-nav", "further-reading", + "getting-logs-and-events", + "going-inside-the-pod", + "introduction", + "need-help-with-life", "offcanvasNavMain", "offcanvasNavMainLabel", "offcanvasNavSection", "offcanvasNavSectionLabel", "query", + "reading-secrets", + "requesting-without-an-ingress", "search-form", "searchModal", "searchModalLabel", diff --git a/public/404.html b/public/404.html index 443bc4e8..c366f669 100644 --- a/public/404.html +++ b/public/404.html @@ -16,7 +16,7 @@ -404 Page not found | My Docs +404 Page not found | Teresa Alves @@ -46,7 +46,7 @@ - + @@ -85,7 +85,7 @@
- My Docs + Teresa Alves @@ -109,7 +109,7 @@
-
My Docs
+
Teresa Alves
+ + +
+
+
Aboutme
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+ + + + + +
+
+ + +
+
+ +
+
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/aboutme/aboutme/index.xml b/public/aboutme/aboutme/index.xml new file mode 100644 index 00000000..7706f0ec --- /dev/null +++ b/public/aboutme/aboutme/index.xml @@ -0,0 +1,20 @@ + + + + About me on Teresa Alves + http://localhost:1313/aboutme/aboutme/ + Recent content in About me on Teresa Alves + Hugo + en + Copyright (c) 2020-2024 Hyas + Thu, 07 Sep 2023 16:04:48 +0200 + + + Quick Summary + http://localhost:1313/aboutme/aboutme/quick-summary/ + Thu, 07 Sep 2023 16:04:48 +0200 + http://localhost:1313/aboutme/aboutme/quick-summary/ + Introduction Hello and welcome! I am Teresa Alves, a Software Engineer from Portugal 🇵🇹 I have a background in Control and Automation (aka Math and Robots) and I have professional experience as a backend, platform and systems engineer. + + + diff --git a/public/aboutme/aboutme/quick-summary/index.html b/public/aboutme/aboutme/quick-summary/index.html new file mode 100644 index 00000000..2ac08962 --- /dev/null +++ b/public/aboutme/aboutme/quick-summary/index.html @@ -0,0 +1,486 @@ + + + + + + + + + + + + + + + +Quick Summary | Teresa Alves + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + Teresa Alves + + + + + + +
+
+
Aboutme
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+
+ + + + +
+
+ + +
+
+ + + + + + + +
+ + +
+ +

Quick Summary

+ + +

Introduction

+

Hello and welcome! +I am Teresa Alves, a Software Engineer from Portugal 🇵🇹 +I have a background in Control and Automation (aka Math and Robots) and I have professional experience as a backend, platform and systems engineer.

+

I am also a volunteer for As Raparigas do Código, a volunteer organization focused including women in the tech world, and to get young childrens interested in technology.

+

This website will share my quick guides to certain technologies, that will help me not forget things, and might help you learn them.

+

Feel free to add me on LinkedIn!

+

Need help with life?

+

If you need help with things, I can help with the following technical things:

+
    +
  • basics of programming;
    • +
  • what is backend, frontend, devops?;
    • +
  • setting up your first API
    • +
  • mock technical interviews;
    • +
  • System design;
    • +
  • Observability;
    • +
  • Other platform related things (feel free to ask);
    • +
+

Non technical stuff:

+
    +
  • Starting a career in tech;
    • +
  • building a CV;
    • +
  • how to show confidence in interviews;
    • +
  • how to deal with anxious dogs;
    • +
+

Feel free to contact me on LinkedIn with any questions

+

Can I contribute?

+

These notes represent things I know or have studied so I don’t really want external contributions for whole new modules. However, feel free to add new issues in this repo for doc requests or propose fixes for somethign I already have that seems incorrect or incomplete!

+ +
+
+
+ +
+
+
+ + + + + + +
+
+
Prev
+ Public Speaking Events +
+
+
+
+
+
+
+
Next
+ Resources +
+
+ + + + + + +
+
+
+
+ + +
+ +
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/docs/guides/sitemap.xml b/public/aboutme/aboutme/sitemap.xml similarity index 80% rename from public/docs/guides/sitemap.xml rename to public/aboutme/aboutme/sitemap.xml index 152fef51..f958d5a1 100644 --- a/public/docs/guides/sitemap.xml +++ b/public/aboutme/aboutme/sitemap.xml @@ -2,7 +2,7 @@ xmlns:xhtml="http://www.w3.org/1999/xhtml"> - http://localhost:1313/docs/guides/example-guide/ + http://localhost:1313/aboutme/aboutme/quick-summary/ 2023-09-07T16:04:48+02:00 monthly 0.5 diff --git a/public/aboutme/events/index.html b/public/aboutme/events/index.html new file mode 100644 index 00000000..d70d4043 --- /dev/null +++ b/public/aboutme/events/index.html @@ -0,0 +1,359 @@ + + + + + + + + + + + + + + + +About me | Teresa Alves + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + Teresa Alves + + + + + + +
+
+
Aboutme
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+
+ + + + +
+
+ + +
+
+ +
+
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/aboutme/events/index.xml b/public/aboutme/events/index.xml new file mode 100644 index 00000000..e4909511 --- /dev/null +++ b/public/aboutme/events/index.xml @@ -0,0 +1,20 @@ + + + + About me on Teresa Alves + http://localhost:1313/aboutme/events/ + Recent content in About me on Teresa Alves + Hugo + en + Copyright (c) 2020-2024 Hyas + Thu, 07 Sep 2023 16:04:48 +0200 + + + Public Speaking Events + http://localhost:1313/aboutme/events/public-speaking-events/ + Thu, 07 Sep 2023 16:04:48 +0200 + http://localhost:1313/aboutme/events/public-speaking-events/ + Diversity and Inclusion in the tech world 27/06/2024 I was a guest in an event for Career Management in Tech where I spoke about the importance of diversity and inclusion in the workplace, as a representative of As Raparigas do Código. + + + diff --git a/public/aboutme/events/public-speaking-events/index.html b/public/aboutme/events/public-speaking-events/index.html new file mode 100644 index 00000000..cf1eb741 --- /dev/null +++ b/public/aboutme/events/public-speaking-events/index.html @@ -0,0 +1,450 @@ + + + + + + + + + + + + + + + +Public Speaking Events | Teresa Alves + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + Teresa Alves + + + + + + +
+
+
Aboutme
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+
+ + + + +
+
+ + +
+
+ + + + + + + +
+ + +
+ +

Public Speaking Events

+ + +

Diversity and Inclusion in the tech world

+
27/06/2024
+

I was a guest in an event for Career Management in Tech where I spoke about the importance of diversity and inclusion in the workplace, as a representative of As Raparigas do Código.

+

I believe that diversity is important for innovation and to achieve the best solutions. However, we do not currently have enough women in tech to have a 50/50 distribution of men and women in these roles. Because of that, we strive to have more girls interested in the area and we want to make sure that the women (and the other tech minorities) that are already in here feel included and have their voices heard. Being empathetic, respectful and inclusive to your coworkers is much more important than hitting quotas. This last part will come eventually, if the overall environment is pleasant and accepting.

+

You can read the summary of the discussion and listen to the whole thing here (in Portuguese).

+ +
+
+
+ +
+
+
+
Next
+ Quick Summary +
+
+ + + + + + +
+
+
+
+ + +
+ +
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/aboutme/events/sitemap.xml b/public/aboutme/events/sitemap.xml new file mode 100644 index 00000000..d908ae08 --- /dev/null +++ b/public/aboutme/events/sitemap.xml @@ -0,0 +1,10 @@ + + + + http://localhost:1313/aboutme/events/public-speaking-events/ + 2023-09-07T16:04:48+02:00 + monthly + 0.5 + + \ No newline at end of file diff --git a/public/aboutme/index.html b/public/aboutme/index.html new file mode 100644 index 00000000..e0cbffd9 --- /dev/null +++ b/public/aboutme/index.html @@ -0,0 +1,364 @@ + + + + + + + + + + + + + + + +Docs | Teresa Alves + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + Teresa Alves + + + + + + +
+
+
Aboutme
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+
+ + + + +
+
+ + +
+
+ +
+
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/aboutme/index.xml b/public/aboutme/index.xml new file mode 100644 index 00000000..66740f5a --- /dev/null +++ b/public/aboutme/index.xml @@ -0,0 +1,20 @@ + + + + Docs on Teresa Alves + http://localhost:1313/aboutme/ + Recent content in Docs on Teresa Alves + Hugo + en + Copyright (c) 2020-2024 Hyas + Tue, 27 Feb 2024 09:30:56 +0100 + + + Resources + http://localhost:1313/aboutme/resources/ + Tue, 27 Feb 2024 09:30:56 +0100 + http://localhost:1313/aboutme/resources/ + Link to valuable, relevant resources. + + + diff --git a/public/docs/guides/example-guide/index.html b/public/aboutme/resources/index.html similarity index 80% rename from public/docs/guides/example-guide/index.html rename to public/aboutme/resources/index.html index bb6d89fb..619fc059 100644 --- a/public/docs/guides/example-guide/index.html +++ b/public/aboutme/resources/index.html @@ -14,10 +14,10 @@ - - -Example Guide | My Docs - + + +Resources | Teresa Alves + @@ -43,20 +43,19 @@ type="image/png" > - - + + - - - + + + - - + + - + + + + + + + + + + + + +Basic Commands | Teresa Alves + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + Teresa Alves + + + + + + +
+
+
Docs
+ +
+
+ +
+
+ + + + +
+
+
Teresa Alves
+ +
+ +
+ + + + + + + + + + + + +
+
+ + +
+
+
+ + + + +
+
+ + +
+
+ + + + + + + +
+ + +
+ +

Basic Commands

+ + +

Baseline commands

+

kubectl get pods - check if the pods are starting correctly. You can add | grep -c <deployment-name> to count how many pods you have at a current time. You can also filter by label:
+kubectl get pods -l 'labelname=labelvalue'

+

kubectl get deploy -o wide - tells you which version it is getting from the repo, so you can be sure that you are deploying to the correct one. You can also check how many replicas are updated.

+

kubectl get configmap <config-map-name> (or kubectl get cm for lazy people like me) - check the config maps that exist. BUT they all already exist basically, so what you usually want to check is what’s inside them with:
+kubectl describe cm <config-map-name>.

+

Note that if you update the configmap, the values read by the pod don’t change automatically. The cm are read at the beginning of the deploy so in order to have it read you need to restart the pods.

+

kubectl get quota - if you see your pods are not starting and your deployment is stuck, it might be because you ran out of quota. You can also check errors in the events

+

Getting logs and events

+

If you need to check events:

+

kubectl get events --sort-by='.metadata.creationTimestamp'

+

And now logs:

+

kubectl get logs -f <pod_name>

+

Or for pods that have been restarted:

+

kubectl get logs <pod_name> —previous

+

Creating Secrets

+

Secrets are objects that generally contain sensitive information, such as tokens or secrets. They behave similarly to a configmap but they are used only for sensitive information, so it’s not hardcoded in the application code.

+

Each secret can have several keys, and therefore, several passwords or other pieces of information. You can therefore have a secret called credentials where inside you have two keys password and user with each respective value. Don’t forget that when reading a secret in your pod.yaml configs you need to specify both the secret name and the key from which you need the value:

+ + + +
+
+
+ +
+ 
- name: ENV_VAR_NAME
+    valueFrom:
+      secretKeyRef:
+        name: secret_name
+        key: password # or whatever your key is
+
+
+

Reading secrets:

+

kubectl edit secret <secret—name> and you can see the secret value there (but don’t edit it!)

+

but it will show you the secret info and the value encoded in base64. To read it back you must do:

+

kubectl get secret <SECRET_NAME> "--template={{.data.password}}" | base64 --decode

+

Note that if you do want to edit it like that, you need to convert it to base64 before that.

+

Accessing other services:

+

From inside the cluster:

+

curl <service-name>.<namespace-name>:<port>

+

If the service you are trying to access is in the namespace as your pod currently is, then you can omit the namespace name and just do
+<service-name>:<port>

+

Or just use the internal ingress associated with the service. Get it with:

+

kubectl get ingress

+

Going inside the pod

+

kubectl exec -it <pod-name> bash → if you have only one container in your pod, it will go inside that container. Otherwise, you will have to specify which container in that pod you are trying to access by using -c <container-name>.

+

printenv - run this command while inside the container to print all the environment variables that this is reading. It is particularly useful to verify if the config map and secrets are being correctly read in the pod.

+

ping <url> or curl <url> - some services are not accessible through your local machine, but only inside the cluster. You can run this inside a pod.

+

Requesting without an ingress

+

kubectl port-forward <pod-name> <local-port:pod-port> - useful to do testing curls from your local machine

+ +
+
+
+ +
+
+
+
Next
+ Basic Commands +
+
+ + + + + + +
+
+
+
+ + +
+ +
+ + +
+
+ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/docs/guides/index.html b/public/docs/kubernetes/index.html similarity index 89% rename from public/docs/guides/index.html rename to public/docs/kubernetes/index.html index 7602962e..222812dd 100644 --- a/public/docs/guides/index.html +++ b/public/docs/kubernetes/index.html @@ -14,9 +14,9 @@ - - -Guides | My Docs + + +Kubernetes | Teresa Alves @@ -43,13 +43,13 @@ type="image/png" > - + - + - + @@ -73,7 +73,7 @@ }, { "@type": "ListItem", - "name": "Guides", + "name": "Kubernetes", "position": 3 } ] @@ -92,7 +92,7 @@
- My Docs + Teresa Alves @@ -134,11 +134,11 @@
Docs
  • - Guides + Kubernetes
    @@ -150,7 +150,7 @@
    Docs
    @@ -176,7 +176,7 @@
    Docs
    -
    My Docs
    +
    Teresa Alves
    diff --git a/public/docs/reference/index.html b/public/docs/reference/index.html index c64858d0..5a30e49c 100644 --- a/public/docs/reference/index.html +++ b/public/docs/reference/index.html @@ -15,8 +15,8 @@ - -Reference | My Docs + +Reference | Teresa Alves @@ -46,7 +46,7 @@ - + @@ -92,7 +92,7 @@
    - My Docs + Teresa Alves @@ -134,11 +134,11 @@
    Docs
  • - Guides + Kubernetes
    @@ -150,7 +150,7 @@
    Docs
    @@ -176,7 +176,7 @@
    Docs
    -
    My Docs
    +
    Teresa Alves
    diff --git a/public/docs/sitemap.xml b/public/docs/sitemap.xml index d0dd0af3..6565ef9c 100644 --- a/public/docs/sitemap.xml +++ b/public/docs/sitemap.xml @@ -2,7 +2,7 @@ xmlns:xhtml="http://www.w3.org/1999/xhtml"> - http://localhost:1313/docs/guides/ + http://localhost:1313/docs/kubernetes/ 2023-09-07T16:06:50+02:00 monthly 0.5 @@ -22,13 +22,13 @@ 0.5 - http://localhost:1313/docs/guides/example-guide/ + http://localhost:1313/docs/kubernetes/basic-commands/ 2023-09-07T16:04:48+02:00 monthly 0.5 - http://localhost:1313/docs/reference/example-reference/ + http://localhost:1313/docs/reference/basic-commands/ 2023-09-07T16:13:18+02:00 monthly 0.5 diff --git a/public/index.html b/public/index.html index 18a3841c..818e1b50 100644 --- a/public/index.html +++ b/public/index.html @@ -16,7 +16,7 @@ - + Welcome to Doks @@ -47,7 +47,7 @@ - + @@ -60,7 +60,7 @@ { "@type": "WebSite", "url": "http://localhost:1313/", - "name": "My Docs", + "name": "Teresa Alves", "description": "Congrats on setting up a new Doks project!" } ] @@ -101,7 +101,7 @@
    - My Docs + Teresa Alves @@ -125,7 +125,7 @@
    -
    My Docs
    +
    Teresa Alves