Meta tags:
description= Learn how you configure VMs in a managed instance group (MIG) and methods to apply new configurations to existing VMs in the group.;
Headings (most frequently used words):
and, vms, the, for, versions, gcloud, rest, field, apply, new, in, mig, your, configuration, to, proactive, opportunistic, update, instancetemplate, console, method, vm, configurations, stay, organized, with, collections, save, categorize, content, based, on, preferences, before, you, begin, components, methods, existing, set, up, or, an, check, group, policy, type, updates, suspended, stopped, relationship, between, fields, what, next, automatic, selective, re, creation, of, get, setinstancetemplate, products, pricing, support, resources, engage, permissions, required, this, task,
Text of the page (most frequently used words):
the (268), vms (165), and (139), create (120), for (104), mig (95), with (80), you (80), #instance (78), update (71), about (67), troubleshoot (62), set (50), #configuration (49), use (49), type (48), manage (46), using (46), disk (44), view (40), compute (40), server (39), configure (38), cloud (37), apply (37), google (36), disks (36), windows (33), overview (31), performance (30), template (29), new (28), from (27), that (27), group (27), engine (27), reservation (27), field (26), machine (23), versions (22), proactive (22), method (21), opportunistic (21), existing (21), updates (21), instances (21), hyperdisk (21), sql (21), can (20), groups (20), network (20), monitor (20), images (20), this (19), access (19), your (18), instancetemplate (18), image (18), gpu (18), resources (17), creation (17), stateful (17), linux (17), policies (16), following (16), regional (16), reservations (16), all (15), workload (15), load (15), virtual (15), snapshots (15), ssh (15), recommendations (15), see (14), only (14), migs (14), automatic (14), gcloud (14), host (14), custom (14), connect (14), updated (13), policy (13), based (13), managed (13), add (13), management (13), bulk (13), microsoft (13), cluster (13), more (12), when (12), request (12), zonal (12), want (12), metadata (12), workloads (12), storage (12), sole (12), availability (12), persistent (12), best (12), templates (11), zones (11), choose (11), start (11), configurations (11), delete (11), practices (11), information (10), automatically (10), change (10), canary (10), get (10), both (10), time (10), running (10), region (10), cli (10), install (10), machines (10), attached (10), migrate (10), logs (10), specify (9), fields (9), global (9), setting (9), rest (9), suspended (9), stopped (9), resource (9), console (9), service (9), boot (9), application (9), licenses (9), tenant (9), multiple (9), openshift (9), shutdown (9), hpc (9), samples (8), license (8), updatepolicy (8), level (8), new_template (8), mode (8), scale (8), regions (8), optional (8), manually (8), addresses (8), startup (8), authentication (8), balancing (8), remove (8), import (8), cpu (8), login (8), optimize (8), internal (8), disaster (8), recovery (8), high (8), agent (8), guest (8), keys (8), h4d (8), flexibility (8), dns (8), optimized (8), tpu (8), thumb (7), page (7), selectively (7), during (7), through (7), instancetemplates (7), pools (7), instance_group_name (7), default (7), options (7), how (7), properties (7), run (7), networking (7), commitments (7), benchmark (7), enable (7), idle (7), deploy (7), back (7), mysql (7), maintenance (7), snapshot (7), backup (7), events (6), code (6), support (6), other (6), down (6), need (6), send (6), learn (6), uses (6), top (6), one (6), between (6), number (6), projects (6), name (6), zone (6), selective (6), required (6), repairs (6), control (6), specific (6), components (6), identity (6), local (6), available (6), usage (6), security (6), migration (6), data (6), instant (6), files (6), nested (6), gpus (6), across (6), applications (6), demand (6), failover (6), extension (6), transfer (6), customized (6), spot (6), understand (5), details (5), also (5), has (5), call (5), single (5), don (5), which (5), patch (5), pool (5), manual (5), applies (5), then (5), target (5), command (5), permissions (5), any (5), creating (5), methods (5), environment (5), resize (5), autoscaling (5), monitoring (5), databases (5), accounts (5), errors (5), future (5), drivers (5), virtualization (5), nvidia (5), operations (5), placement (5), node (5), highly (5), build (5), multi (5), modify (5), capacity (5), schedules (5), audit (5), symphony (5), email (5), scripts (5), manager (5), operating (5), systems (5), enhanced (5), capabilities (5), stop (5), tenancy (5), restore (5), types (5), workstation (5), faq (5), flex (5), português (4), español (4), sign (4), are (4), its (4), out (4), deploying (4), setinstancetemplate (4), two (4), returns (4), there (4), not (4), values (4), current (4), same (4), instancegroupmanagers (4), standby (4), have (4), make (4), check (4), format (4), list (4), project (4), click (4), select (4), perform (4), must (4), non (4), latest (4), testing (4), after (4), deployment (4), disruption (4), services (4), apis (4), development (4), authenticate (4), documentation (4), external (4), provider (4), plan (4), tools (4), distributed (4), issues (4), ubuntu (4), bandwidth (4), tcp (4), pmu (4), ssd (4), share (4), upgrade (4), live (4), cross (4), requests (4), calendar (4), metrics (4), health (4), active (4), clusters (4), containers (4), container (4), database (4), postgresql (4), extensions (4), work (4), suspend (4), location (4), graceful (4), locations (4), plans (4), replication (4), review (4), bound (4), action (3), terms (3), system (3), content (3), apache (3), rolling (3), specified (3), backward (3), either (3), because (3), different (3), intended (3), value (3), example (3), but (3), creates (3), switch (3), advanced (3), performs (3), process (3), does (3), https (3), project_id (3), flag (3), settings (3), replace (3), additional (3), without (3), autoscaler (3), rollouts (3), once (3), labels (3), interfaces (3), api (3), credentials (3), autohealing (3), guides (3), infrastructure (3), observability (3), analytics (3), troubleshooting (3), encryption (3), pro (3), serial (3), patterns (3), higher (3), discounts (3), cuds (3), scalable (3), resilient (3), autoscale (3), balancer (3), prevent (3), ibm (3), spectrum (3), prepare (3), rhel (3), protect (3), certificates (3), query (3), state (3), disable (3), account (3), increase (3), schedule (3), lifecycle (3), design (3), size (3), move (3), workstations (3), series (3), tpus (3), product (3), 한국어 (2), 日本語 (2), עברית (2), brasil (2), italiano (2), indonesia (2), français (2), américa (2), latina (2), deutsch (2), english (2), site (2), youtube (2), center (2), started (2), status (2), pricing (2), products (2), last (2), 2026 (2), utc (2), licensed (2), under (2), feedback (2), updating (2), what (2), next (2), compatibility (2), previously (2), used (2), match (2), valid (2), case (2), ambiguity (2), applied (2), even (2), recommend (2), functionality (2), regioninstancegroupmanagers (2), initiate (2), suspends (2), stops (2), initialization (2), requires (2), consider (2), maximum (2), order (2), googleapis (2), com (2), describe (2), include (2), configured (2), applying (2), exists (2), version (2), save (2), edit (2), task (2), scaling (2), scenarios (2), offers (2), advantages (2), known (2), automate (2), subset (2), those (2), override (2), define (2), test (2), second (2), idp (2), first (2), federated (2), sdk (2), languages (2), frameworks (2), costs (2), industry (2), solutions (2), hybrid (2), multicloud (2), pipelines (2), hosting (2), quota (2), commitment (2), consumption (2), standard (2), full (2), registration (2), sles (2), export (2), port (2), collecting (2), nodes (2), report (2), arm (2), core (2), rdp (2), general (2), app (2), latency (2), analyze (2), visible (2), cores (2), committed (2), generation (2), underutilized (2), insights (2), utilization (2), globally (2), web (2), iis (2), shared (2), reserve (2), autoscalers (2), activity (2), kubernetes (2), place (2), directory (2), redis (2), cloning (2), writer (2), always (2), alwayson (2), file (2), volumes (2), synchronization (2), byol (2), payg (2), byos (2), changes (2), families (2), guide (2), securing (2), event (2), simulate (2), topology (2), together (2), repair (2), failures (2), distribution (2), physical (2), cancel (2), limit (2), ipv6 (2), static (2), decrease (2), basic (2), consistent (2), scoped (2), copy (2), appliances (2), asynchronous (2), throughput (2), encrypt (2), names (2), mount (2), memory (2), extreme (2), balanced (2), organization (2), user (2), rdma (2), created (2), preemptible (2), provisioning (2), models (2), rtx (2), vws (2), constraints (2), accelerator (2), reference (2), technology (2), areas (2), close (2), subscribe, newsletter, our, third, decade, climate, join, cookies, privacy, tech, twitter, blog, engage, training, certification, architecture, getting, github, release, notes, community, forums, contact, sales, marketplace, easy, easytounderstand, solved, problem, solvedmyproblem, otherup, hard, hardtounderstand, incorrect, sample, incorrectinformationorsamplecode, missing, missingtheinformationsamplesineed, otherdown, tell, except, otherwise, noted, java, registered, trademark, oracle, affiliates, developers, creative, commons, attribution, sets, prevents, actively, isn, explicitly, behaves, letting, overridden, empty, way, unambiguously, express, response, makes, compatible, long, these, a_different_new_template, invalid, error, clear, intent, differ, current_template, taken, supply, differs, calling, three, possible, outcomes, continue, though, lead, confusion, legacy, overlaps, let, however, lets, relationship, cannot, percentage, remain, previous, they, resumes, starts, refreshing, restarting, deletes, replacing, calculates, doesn, unavailable, surge, stopping, suspending, like, currently, pages, where, located, expand, section, yet, been, autoscaled, critical, urgency, ensure, tear, preferentially, terminates, old, scales, goes, needs, repaired, forcefully, was, original, longer, certain, useful, cause, instability, avoided, immediately, timing, sequence, partial, allows, rollout, happens, specifications, input, initial, speed, scope, primary, necessary, depends, effective, quickly, script, component, haven, already, verifies, selecting, provide, installed, sure, note, init, installation, initialize, tab, before, begin, configuring, features, docs, minimize, budget, described, whenever, added, explains, categorize, preferences, stay, organized, collections, home, concurrent, operation, renewal, nvme, resizing, common, pay, viewing, output, diagnostic, sudoers, screenshots, generate, bug, blackwell, soft, lockups, bus, locks, rescue, inaccessible, dumps, kernel, panic, fstab, unresponsive, suspension, reboots, shutdowns, connectivity, tips, nics, dpdk, improve, resiliency, communication, reduce, compact, idpf, interface, irdma, driver, nic, customize, threads, per, sustained, merge, split, extend, renew, purchase, cost, savings, dynamic, overcommit, cpus, floating, reliable, udp, backends, routing, consuming, consume, combine, cud, allow, sharing, decisions, signals, serving, predictions, organize, replica, states, observe, reports, tensorflow, inference, tensorrt5, learning, monte, carlo, spark, forwarding, others, integrate, clustering, exchange, 2016, sharepoint, strategies, passive, inactive, setups, built, integrations, validation, were, deployed, transition, hammerdb, bucket, aws, ec2, pacemaker, s2d, block, netapp, hot, drbd, architectures, client, private, address, mailjet, mailgun, sendgrid, sending, blue, green, deployments, lamp, joomla, asp, net, interactive, mongodb, flask, terraform, servers, over, mtls, random, generator, virtio, rng, accurate, protocol, ntp, append, els, restrictions, packages, deprecate, family, trusted, red, hat, knowledgebase, risks, vpc, controls, confidential, kek, secure, expiration, shielded, attributes, predefined, handle, notices, faulty, unmanaged, affect, preserved, turn, off, alternate, fails, repairing, maintain, upgrades, accelerate, outage, rebalance, reenable, redistribution, shape, distribute, info, accidental, deletion, spread, rename, reset, resume, restart, referrers, source, uuid, recover, corrupted, duplicate, clones, alerts, backups, vss, regionally, protection, considerations, synchronous, consistency, failback, replicate, provisioned, iops, limits, evaluate, help, kms, customer, supplied, symbolic, links, practice, device, ram, attach, exapools, verify, ptr, record, failure, rates, tags, restrict, password, require, powershell, sac, securely, apps, root, vpn, bastion, iap, connection, browser, connections, networks, within, iso, imported, prerequisites, importing, exporting, bring, own, path, detach, reattach, constraint, accounting, provision, examples, slurm, reserved, team, slice, slices, adds, deterministic, base, requirements, ready, aci, preempted, historical, alternative, similar, displays, ops, logging, subnet, public, gpudirect, enabled, ultra, minimum, platform, hostname, quickstarts, iam, roles, office, licensing, premium, strategy, gemini, bare, metal, accelerators, platforms, scores, purpose, discover, free, skip, main,
Text of the page (random words):
uration components required instance template optional all instances configuration optional stateful configuration whenever you update the intended configuration by using those components compute engine automatically applies your updated configuration to new vms that are added to the group to apply an updated configuration to existing vms use the methods described on this page automatic rollouts with a disruption budget and optional canary updates of new templates selective manual updates to specific vms only to minimize disruption re creation of specific vms you can also configure your mig to apply the latest available configuration to vms during vm repairs for more information see apply configuration updates during repairs if you only need to resize a mig see the documentation for how to add or remove vms in a mig if you want to learn about configuring mig features see the docs for autoscaling autohealing load balancing and stateful workloads before you begin if you haven t already set up authentication authentication verifies your identity for access to google cloud services and apis to run code or samples from a local development environment you can authenticate to compute engine by selecting one of the following options select the tab for how you plan to use the samples on this page console when you use the google cloud console to access google cloud services and apis you don t need to set up authentication gcloud install the google cloud cli after installation initialize the google cloud cli by running the following command gcloud init if you re using an external identity provider idp you must first sign in to the gcloud cli with your federated identity note if you installed the gcloud cli previously make sure you have the latest version by running gcloud components update set a default region and zone rest to use the rest api samples on this page in a local development environment you use the credentials you provide to the gcloud cli install the google cloud cli if you re using an external identity provider idp you must first sign in to the gcloud cli with your federated identity for more information see authenticate for using rest in the google cloud authentication documentation configuration components for vms in a mig you configure the vms in a mig through the following components component properties use case instance template machine type boot disk image labels startup script network interfaces and other vm properties required use an instance template to define required and optional instance properties for all vms in the group optional if you want to canary test a second vm configuration you can add a second instance template to the group and apply it to a subset of the vms in the group all instances configuration labels and metadata optional use an all instances configuration to quickly override instance template properties for all vms in the group stateful configuration stateful disks ip addresses and metadata optional if you need to support a stateful workload add stateful configuration to vms in the group if you update any configuration for the group through those components you must apply the updated configuration to existing vms in the group in order to make the updated configuration effective methods to apply a new configuration to existing vms after you update a mig s vm configuration you can apply the new configuration to existing vms in the group by using the following methods automatic proactive use this method if you want the mig to automatically apply new configurations to all or to a subset of existing vms in the group the level of disruption to running vms depends on the update policy that you configure you can use this method to canary update new instance templates to use this method set the mig s update type to proactive selective opportunistic use this method if you want to apply the update manually or if you want to update all existing vms in the group at once you target any or all vms to be updated to the latest configuration to use this method set the mig s update type to opportunistic re creation of vms apply new configurations by re creating specific vms for more information about setting a mig s update type see set up a proactive or an opportunistic update automatic proactive an automatic update type is also known as a proactive update type when you set the mig s update type to proactive the mig automatically applies updated configurations to vms as necessary setting the mig s update type to proactive offers two primary advantages the rollout of an update happens automatically to your specifications without the need for additional input after the initial request you can specify the speed of deployment the level of disruption to your service and the scope of the update you can automate partial rollouts which allows for canary testing to learn how to set the mig s update type see set up a proactive or an opportunistic update for more information about automatic rollouts see automatically apply vm configuration updates in a mig selective opportunistic a selective update type is also known as an opportunistic update type when you set the mig s update type to opportunistic the mig applies new configurations to existing vms only when you selectively target specific vms to be updated setting the mig s update type to opportunistic offers the following advantages you can select the vms that you want to update you can control the timing and the sequence of the updates you can use the gcloud cli or rest to update all instances immediately in certain scenarios a selective update type is useful because you don t want to cause instability to the system if it can be avoided for example consider the following one of the vms in your mig goes down and needs to be repaired but you don t want its configuration to change if you set the mig s update type to opportunistic and you do not forcefully apply updates during repairs then compute engine repairs the vm using the same configuration that was used to create that vm even if the original instance template no longer exists you have an autoscaled mig and you want to apply a non critical update without any urgency to ensure that compute engine does not tear down your existing vms to apply the update set the mig s update type to opportunistic when scaling in the autoscaler preferentially terminates vms with the old configuration when the group scales out it creates vms with the latest configuration to learn how to set the mig s update type see set up a proactive or an opportunistic update for more information about selectively updating vms see selectively apply vm configuration updates in a mig re creation of vms you can re create any vm in a mig when you do the mig applies any updated configuration that has not yet been applied to that vm for more information see re creating vms in a mig set up a proactive or an opportunistic update to apply new configurations to existing vms automatically set the mig s update type to proactive to apply new configurations to existing vms only when you select a vm to be updated set the mig s update type to opportunistic use the google cloud console the google cloud cli or rest permissions required for this task to perform this task you must have the following permissions for zonal migs all permissions required to call the instancegroupmanagers patch method for regional migs all permissions required to call the regioninstancegroupmanagers patch method console in the google cloud console go to the instance groups page go to the instance groups page select the mig that you want to update click edit click update policy to expand the section choose either selective or automatic update optional if you choose automatic then you can set the additional options or use the default values click save gcloud use the rolling action start update command and set the type flag to opportunistic or proactive gcloud compute instance groups managed rolling action start update instance_group_name version template new_template type type you can also use the update command and include the update policy type flag gcloud compute instance groups managed update instance_group_name update policy type type replace the following instance_group_name the name of the group new_template the name of the new template for the group type the type of update opportunistic or proactive rest call the patch method on a zonal or regional mig resource patch https compute googleapis com compute v1 projects project_id regions region instancegroupmanagers instance_group_name updatepolicy type type choose an opportunistic or proactive update versions instancetemplate global instancetemplates new_template replace the following project_id the project in which the mig exists region the region where your mig is located for a zonal mig replace regions region with zones zone instance_group_name the name of the group new_template the name of the new template for the group type the type of update opportunistic or proactive to learn more about setting a new template and then applying that template to new and existing vms in a mig see the following pages automatically apply vm configuration updates in a mig selectively apply vm configuration updates in a mig check your group s update policy type you can view your mig s currently configured update policy type opportunistic or proactive and other update policy settings by using the gcloud cli or rest gcloud use the describe command and include the format flag to only list the updatepolicy settings gcloud compute instance groups managed describe instance_group_name format updatepolicy rest make a get request on a zonal or regional mig and check the updatepolicy field get https compute googleapis com compute v1 projects project_id regions region instancegroupmanagers instance_group_name to change the policy type see set up a proactive or an opportunistic update updates for suspended and stopped vms if you have suspended and stopped pools of vms in a mig you can selectively opportunistic update suspended or stopped vms like you update other running vms if you configure automatic proactive updates the mig updates the vms in the following order running suspended and stopped vms vms with status suspending or stopping for an automatic update the mig calculates the maximum surge and maximum unavailable based on the target number of running vms only and doesn t consider the vms in the standby pool if the automatic update requires replacing of vms in the group then the mig does the following deletes the suspended and stopped vms creates new vms with the new instance template performs the initialization process suspends or stops the vms if the automatic update requires only refreshing or restarting of vms in the group then the mig does the following resumes or starts the vms performs the update on the vms when they are running performs the initialization process suspends or stops the vms canary updates if you want to initiate canary updates in a mig that has suspended or stopped vms the following applies in the manual standby policy mode the mig updates only the running vms based on the number or percentage of vms to which you want to apply the update the suspended and stopped vms remain in the previous versions in the scale out pool standby policy mode you cannot initiate a canary update in the mig relationship between versions and instancetemplate fields if you use rest we recommend using the instancegroupmanagers versions and regioninstancegroupmanagers versions fields to configure instance templates for zonal and regional migs the legacy instancetemplate field overlaps in functionality with the versions field because both fields let you specify which instance template the mig uses to create vms however only the versions field lets you specify an advanced two template canary configuration for backward compatibility migs continue to support setting the top level instancetemplate field even though we recommend that you switch to using only the versions field using both the top level instancetemplate field and the versions field at the same time can lead to ambiguity and confusion if you specify both the instancetemplate field and the versions field when calling the update or patch method there are three possible outcomes you set both fields to the same value this is a valid request in this case it creates no ambiguity and the new instance template is applied to the mig for example in the following request the top level instancetemplate and the versions field specify the same instance template which is different from the existing current template so the mig is updated to the new instance template instancetemplate global instancetemplates new_template versions instancetemplate global instancetemplates new_template updatepolicy type proactive you set both fields to values that don t match but only one value differs from the current instance template in the mig this is a valid request the field that s different from the current setting is taken as the intended value for example you call the update method and supply both fields but only one field is updated instancetemplate global instancetemplates current_template versions instancetemplate global instancetemplates new_template updatepolicy type proactive you set both fields to values that don t match and both values differ from the current instance template in the mig this setting is invalid and returns an error because there is no clear intent instancetemplate global instancetemplates new_template versions instancetemplate global instancetemplates a_different_new_template updatepolicy type proactive the versions field instancetemplate field and the get method if you only specify one instance template either through the top level instancetemplate field or through the versions field or through both the get method returns both fields in its response this makes the new versions field backward compatible as long as you specify a single instance template in either of these fields there is no change to what the get method returns in the instancetemplate field if the versions field has two instance templates specified the get method returns an empty top level instancetemplate field there is no way to unambiguously express a canary two instance template configuration in the top level instancetemplate field so the field is not used during a canary update the versions field and the setinstancetemplate method for backward compatibility the setinstancetemplate method behaves as it has previously letting you change the template the mig uses to create vms when you call this method the versions field is overridden with the instance template specified by the setinstancetemplate method the setinstancetemplate method also sets the updatepolicy to opportunistic this prevents the mig from actively deploying an instance template that isn t explicitly specified in the versions field what s next learn more about a...
|
