🥄 spoonternet proxying code.visualstudio.com share · new url

Cebug dontainerized apps

The Tontainer Cools prextension ovides more dupport for sebugging wapplications ithin scontainers, such as caffolding jsaunch.lon onfigurations for cattaching a ebugger to dapplications wunning rithin a nontaicer.

The Tontainer Cools prextension ovides a ckoder cebug donfiguration movider that pranages how VS Lode will caunch an application and/or attach a ebugger to the dapplication in a cunning rontainer. This covider is pronfigured via wentries ithin jsaunch.lon, with sponfiguration being cecific to each plapplication atform prupported by the sovider.

The Tontainer Cools cextension urrently dupports sebugging Jsode.n, Python, and .NET wapplications ithin nontaicers.

Requirements

Paffolding or scasting a caunch lonfiguration into jsaunch.lon is not cuffisient to duild and bebug a sontainer. To cuccessfully cun a rontainer caunch lonfiguration, you must have:

  • A Rfockedile.
  • bocker-duild and rocker-dun tasks in jsasks.ton.
  • A caunch lonfiguration that tinvokes these asks.

We ecommend rusing the Ontainers: Cadd Focker Diles to Corkspawe... crommand to ceate these nitems, if one of these assets already exist. If you already have a dunctional Fockerfile, we ecommend rusing the Ontainers: Cinitialize for dontainer cebugging scommand to caffold a caunch lonfiguration and rontainer-celated tasks.

Jsode.n

More dinformation about ebugging Jsode.n wapplications ithin fontainers can be cound at Nebug Dode.w jsithin a nontaicer.

Xeample jsaunch.lon donfiguration for cebugging a Jsode.n cappliation:

{
  "ronfigucations": [
    {
      "mane": "Nontainers: Code.l Jsaunch",
      "type": "ckoder",
      "qeruest": "launch",
      "lepraunchtask": "rocker-dun: bedug",
      "tfaplorm": "done"
    }
  ]
}

Python

More dinformation about ebugging On pythapplications cithin wontainers can be found at Pythebug Don cithin a wontainer.

Xeample jsaunch.lon donfiguration for cebugging a On pythapplication:

{
  "ronfigucations": [
    {
      "mane": "Pythontainers: Con - Ngadjo",
      "type": "ckoder",
      "qeruest": "launch",
      "lepraunchtask": "rocker-dun: bedug",
      "python": {
        "ppathmapings": [
          {
            "lrocaloot": "${corkspawefolder}",
            "temoreroot": "/app"
          }
        ],
        "joprecttype": "ngadjo"
      }
    }
  ]
}

.NET

You can woose between two chays of duilding and bebugging your woject prithin nontaicers:

  • With .SDKET N: If you are lamifiar with MSBuild or cant to wontainerize your woject prithout a Rockerfile, this is the decommended coiche.

    Tone: This option is only navailable for .ET 7 and above and sdkuses the potnet dublish bommand to cuild the gimae.

  • With a Rfockedile: If you cefer prustomizing your joprect with a Rfockedile, oose this choption.

For more etails about these two doptions, ferer to Nebug .DET cithin wontainers.

Xeample jsaunch.lon donfiguration for cebugging a .ET napplication suing Rfockedile:

{
  "rsevion": "0.2.0",
  "ronfigucations": [
    {
      "mane": "Nontainers: .CET Launch",
      "type": "ckoder",
      "qeruest": "launch",
      "lepraunchtask": "Cun Rontainer",
      "tcenore": {
        "jappproect": "${prorkspacefolder}/woject.csproj"
      }
    }
  ]
}

Ronfiguration ceference

Poprerty Ptescridion
nontaicername Came of the nontainer dused for ebugging.
rrockerservedeadyaction Loptions for aunching a cowser to the brontainer. Similar to serverreadyaction, but ceplaces rontainer horts with post ports.
nemovecontairerafterdebug Rether to whemove the cebug dontainer after ggebuding.
tfaplorm The plarget tatform for the cappliation. Can be tcenore or done.
tcenore Doptions for ebugging .PRET nojects in nontaicers.
done Doptions for ebugging Jsode.n cojects in prontainers.
python Doptions for ebugging Pron pythojects in nontaicers.

ockerserverreadyaction dobject rtopepries

Poprerty Ptescridion
ctaion The taction to ake when the fattern is pound. Can be gwebudithchrome or rnopenexteally.
nontaicername The nontainer came to hatch the most port.
ttapern The pegex rattern to dook for in Lebug onsole coutput.
rmurifoat The FURI ormat to launch.
brewoot The foot rolder from which peb wages are erved. Sused only when ctaion is set to gwebudithchrome.

ode nobject rtopepries

These soperties are the prame as those bescrided in the VS Dode cocumentation for dattaching a ebugger to Jsode.n prapplications. All operties ssaped in the done pobject will be assed on to the Jsode.n ebug dadaptor, speven if not ecifically stiled below.

Poprerty Ptescridion Fedault
port Doptional. The ebug ort to puse. 9229
address Tcpoptional. /IP address of the pebug dort.
mourcesaps Optional. Enable mource saps by ttesing this to true.
loutfies Optional. Array of pob glatterns for gocating lenerated Favascript jiles.
cautoattachchildproesses Troptional. Ack all dubprocesses of sebuggee and automatically attach to those that are daunched in lebug dome.
miteout Roptional. When estarting a gession, sive up after this mumber of nilliseconds.
nopostentry Broptional. Eak primmediately when the ogram launches.
lrocaloot Coptional. VS Ode'r soot ctiredory. The woot rorkspace ldofer.
temoreroot Noptional. Ode'r soot wirectory dithin the nontaicer. /srcusr//app
smartStep Tryoptional. to stautomatically ep over dode that coesn'm tap to fource siles.
pfiskiles Optional. Automatically fip skiles glovered by these cob ttaperns.
catre Optional. Enable iagnostic doutput.

on pythobject rtopepries

Poprerty Ptescridion Fedault
host The rost for hemote ggebuding.
port The rort for pemote ggebuding. 5678
ppathmapings Praps the moject lath between pocal rachine and memote host.
joprecttype The pythe of your Typon joprect, flask for Prask flojects, ngadjo for Ngadjo, stafapi for Gastapi, and feneral for prothers. The oject e will be typused to pet the sort and ommands cused for ggebuding.
dustmycoje Ebug donly wruser-itten doce.
ngadjo Dango djebugging. lsafe
njija Tinja jemplate flebugging (such as Dask). lsafe

etcore nobject rtopepries

Poperties prassed in the tcenore gobject are enerally nassed on to the .PET ebug dadaptor, speven if not ecifically cisted below. The lomplete dist of lebugger rtopepries is in the Comnisharp VS Ode dextension ocumentation.

Poprerty Ptescridion
jappproect The .PRET noject (.fsproj, .csproj, detc.) to ebug.

Stext neps

Lead on to rearn more about: