🚧 Example: Scheduled maintenance tomorrow

[thomasmerz]

This is an example of how you can set up a scheduled maintenance event. To set this up, create a new issue in your @upptime repository and add the label maintenance to it. Then, you can add details in the comments. Make sure you also add an HTML comment at the beginning of the issue, which looks like this:

<!--
start: 2021-02-24T13:00:00.220Z
end: 2021-02-24T14:00:00.220Z
expectedDown: google, hacker-news
-->

More here: https://upptime.js.org/docs/scheduled-maintenance

[thomasmerz]

Original See upptime/upptime#267

[thomasmerz]

This

start: 2021-03-12T00:30:00.220Z
end: 2021-03-12T02:00:00.220Z

means:

start: 2021-03-12T01:30:00.220Z
end: 2021-03-12T03:00:00.220Z

⚠️

[modem7]

Just an FYI - an easy way to generate the start/end string in bash is:

date +"%Y-%m-%dT%H:%M:%S%z"

Output: 2021-09-14T11:02:48+0100

That will also append the appropriate timezone as well.

Or if you don't have a terminal to hand:
https://rextester.com/LRHG10863

Have tested this successfully here: modem7/Status#31

[modem7]

Hopefully this will help people a bit more than the above.

https://rextester.com/HGYD18980

I've created a (probably poorly written) script that has everything required w/ appropriate TZ and some Github text formatting to create a maintenance issue.

#!/bin/bash
# Script to easily create maintenance window issue for Upptime.
# Author: modem7 - https://github.com/modem7

##################################
###### Change these values #######
##################################

# Edit Timezone if required
export TZ=Europe/London

# Enter how long your maintenance window is for
mainthour="1" # 0 value allowed
maintmin="30" # 0 value allowed

# Enter services to be down (make sure to keep the quotes, and comma separate the values)
expecteddown="website, analytics"

###########################################
###### Don't change these variables #######
###########################################

# Start time variable. Don't change.
    starttime=$(date +"%Y-%m-%dT%H:%M:%S%z")

# Maintenance window variables. Don't change.
    maintwindow="${mainthour} hours ${maintmin} minutes"

    endtime=$(date -d "${maintwindow} hence" +"%Y-%m-%dT%H:%M:%S%z")

    nicestart=$(date -d "$(echo ${starttime} | sed 's/T/ /')")
    niceend=$(date -d "$(echo ${endtime} | sed 's/T/ /')")

#####################
###### Output #######
#####################

# Output required fields for maintenance issue.
echo "#################### Copy values below ####################"
echo "### Scheduled maintenance"
echo "Affected services: _**$expecteddown**_"
echo "Lasting from _**$nicestart**_ to _**$niceend**_"
echo
echo "<!--"
echo "start: $starttime"
echo "end: $endtime"
echo "expectedDown: $expecteddown"
echo "-->"
echo "#################### Copy values above ####################"

[thomasmerz]

Reminder for me: Timezone!!!