Ensure Featured Tutorials are up-to-date, accurate, and conform to guidelines

[bermudezmt]

Problem description

Revisit Featured Tutorials:

• [x] AWS
  • [x] https://www.pulumi.com/docs/tutorials/aws/ec2-webserver/
  • [x] https://www.pulumi.com/docs/tutorials/aws/ecs-fargate/
  • [x] https://www.pulumi.com/docs/tutorials/aws/rest-api/
  • [x] https://www.pulumi.com/docs/tutorials/aws/s3-website/
• [ ] Azure
  • [ ] https://www.pulumi.com/docs/tutorials/azure/container-webserver/
  • [ ] https://www.pulumi.com/docs/tutorials/azure/azure-ts-webserver/
  • [ ] https://www.pulumi.com/docs/tutorials/azure-ts-serverless-url-shortener-global/
  • [ ] https://www.pulumi.com/docs/tutorials/azure/azure-ts-appservice-springboot/
• [ ] GCP
  • [ ] https://www.pulumi.com/docs/tutorials/gcp/gce-webserver/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/gke/
  • [ ] https://www.pulumi.com/docs/tutorials/gcp/gcp-ts-functions/
  • [ ] https://www.pulumi.com/docs/tutorials/gcp/gcp-ts-k8s-ruby-on-rails-postgresql/
• [ ] Kubernetes
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/aks/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/eks/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/gke/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/exposed-deployment/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/wordpress-chart/
  • [ ] https://www.pulumi.com/docs/tutorials/kubernetes/guestbook/

Relates to https://github.com/pulumi/docs/issues/1656

[joeduffy]

@danfhernandez I know you've been going through these lately. We'd love your feedback overall on what needs improving. Also, would love if you can pair review some this as Maria makes progress!

[danfhernandez]

@joeduffy yeah happy to help here! Let me know what I can do @bermudezmt.

I have general recommendations for docs but nothing general on the tutorials, just a few specifics that I've noted so far.

[bermudezmt]

@danfhernandez I updated the issue to include all the featured tutorials. Thanks again for helping with this!

[danfhernandez]

Started working on the Azure examples. See sheet for comments and progress: https://docs.google.com/spreadsheets/d/1CA6qzit2AZjDFHP22lkG_TKekar1x0ontTyCYcU5FrY/edit?usp=sharing

[danfhernandez]

Two of the azure examples aren't working for me:

1. CosmosDB and Functions

• Failed at step 6. Was not able to add a url shortener example. Got Warning: Failed to open {"id":"pulumi","url":"https://pulumi.com"}

2. Azure App Service

• Fails with error: COPY failed: stat /var/lib/docker/tmp/docker-builder109089812/.classpath: no such file or directory at pulumi up

See more details here: https://docs.google.com/spreadsheets/d/1CA6qzit2AZjDFHP22lkG_TKekar1x0ontTyCYcU5FrY/edit?usp=sharing

@mikhailshilkov I see you're the author for these, can you check those to make sure it's not user error on my part?

[mikhailshilkov]

@danfhernandez

Item (1) - Step 6 failed because -D option should be -d. Interestingly enough, this was fixed long time ago in the examples repo. It looks like we never update tutorials from the sources? I also opened #524 to improve the next step.

Item (2) - copying @praneetloke here as the original author

[lukehoban]

It looks like we never update tutorials from the sources?

@joeduffy what was the originally intended process around this tool and keeping things up to date? Can it be automated?

[lukehoban]

@danfhernandez @spara What's the overall status here. Were the two issues Dan called out above the only two issues we identified? Is there a finite set of work remaining? Is there clear high priority work we are going to do to address the biggest opportunities?

[danfhernandez]

Those are the only blocking issues I found from the Azure tutorials but left more general feedback here: https://docs.google.com/spreadsheets/d/1CA6qzit2AZjDFHP22lkG_TKekar1x0ontTyCYcU5FrY/edit#gid=0. This is something I'd like to finish. I'll see if I can wrap this up by Friday.

[joeduffy]

what was the originally intended process around this tool and keeping things up to date? Can it be automated?

No original thought here, sorry, other than "similar to our API docs update process" and "yes, it would be great to be automated" (assuming we want to keep this system here overall).